NerdGraph tutorial: view, create, and rename accounts

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 the New Relic One user model. Other permissions-related requirements:
  • Required user type: either core user or full platform user
  • Required role: Organization manager or Authentication domain manager

Before you start

Before you use NerdGraph to manage your accounts, it will probably help you to understand:

• What New Relic accounts are and what they're used for
• 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 diffrent 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" } }
      }