NerdGraph tutorial: view, create, and rename accounts

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

For requirements to manage organization-level settings via NerdGraph, see Add accounts.

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 and managedAccounts 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 or EU. 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:

extensions: { nerdGraphExtensions: { errorClass: "ACCESS_DENIED" } }
    }

cannot create subaccount -- multiple parent account ids found. Please use Partnership API.", {
        extensions: { nerdGraphExtensions: { errorClass: "SERVER_ERROR" } }
      }