As an alternative to using the New Relic UI, you can use NerdGraph to view your organization's accounts, create accounts, and rename accounts.
Requirements
Requirements to manage accounts via NerdGraph include:
- Requires Pro or Enterprise edition (Standard edition organizations can only have one account).
- You must be a user on our newer user model. Other permissions-related requirements:
Before you start
Before you use NerdGraph to manage your accounts, it will probably help you to understand:
- What accounts are and what they're used for
- That you can also manage and add accounts via the UI.
- The basics of using NerdGraph
- That you can track changes to your New Relic account
This tutorial will show you how to:
- View accounts
- Rename accounts
- Add accounts
Tips on terms and fields
Some tips about some of the fields used in these requests:
- The
managedAccount
andmanagedAccounts
fields are simply terms for the accounts in an organization. They're synonymous with "accounts." - The
regionCode
field refers to the data center used by an account:US
orEU
. Note that an organization can only use a single data center: there can't be accounts that use different data centers in a single organization.
Note that the NerdGraph explorer has built-in docs that defines fields.
View accounts
Here's an example of returning the accounts in your organization:
{ actor { organization { accountManagement { managedAccounts { name id regionCode } } } }}
Create accounts
Here's an example of how to create an account. Before creating an account, make sure you understand what an account is used for.
mutation {
accountManagementCreateAccount(managedAccount: {name: "NEW_ACCOUNT_NAME"}) {
managedAccount {
id
name
regionCode
}
}
}
Rename an account
Here's an example of how to rename an account.
mutation {
accountManagementUpdateAccount(managedAccount: {name: "UPDATED_ACCOUNT_NAME", id: 101010101}) {
managedAccount {
id
name
regionCode
}
}
}
Errors
Here are some errors and what they mean:
Error message | Likely cause |
---|---|
| This points to a problem with your organization structure (for example, an account that is outside the boundaries of an organization). If you get this message, contact support or your account representative. |
| This is a message returned when your organization has more than one "parent account," which is an indicator that your organization has a complex account structure that was set up with the Partnership API and requires the use of that API. Have questions? Contact support or your account representative. |
Other errors | Contact support or your account representative. |