NerdGraphチュートリアル：アカウントの表示、作成、名前変更

New Relic UIを使用する代わりに、 NerdGraphを使用して、組織のアカウントを表示したり、アカウントを作成したり、アカウントの名前を変更したりできます。

要件

NerdGraph を介して組織レベルの設定を管理するための要件については、アカウントの追加 を参照してください。

始める前に

NerdGraphを使用してアカウントを管理する前に、次のことを理解するのに役立つでしょう。

• アカウントとは何か、そしてそれらは何のために使われるのか
• UI を介してアカウントを管理および追加することもできます。
• NerdGraphの使用の基本
• NewRelicアカウントへの変更を追跡できること

このチュートリアルでは、次の方法を説明します。

• アカウントを表示する
• アカウントの名前を変更する
• アカウントの追加

用語とフィールドに関するヒント

これらのリクエストで使用されるいくつかのフィールドに関するヒント：

• managedAccountフィールドとmanagedAccountsフィールドは、組織内のアカウントの単なる用語です。それらは「アカウント」と同義です。
• regionCode フィールドは、 アカウントが使用するデータ センターを参照します。有効な値は us01 と eu01 で、それぞれ米国と EU 地域にマップされます。

NerdGraphエクスプローラーには、フィールドを定義するドキュメントが組み込まれていることに注意してください。

アカウントを表示する

組織内のアカウントを返す例を次に示します。

{
  actor {
    organization {
      accountManagement {
        managedAccounts {
          name
          id
          regionCode
        }
      }
    }
  }
}

アカウントを作成する

アカウントを作成する方法の例を次に示します。アカウントを作成する前に、アカウントが何に使用されるかを理解してください。

mutation {
  accountManagementCreateAccount(managedAccount: { name: "NEW_ACCOUNT_NAME" }) {
    managedAccount {
      id
      name
      regionCode
    }
  }
}

アカウント構造が複雑な場合は、オプションの regionCode パラメータを使用して特定のデータ センターをターゲットにすることができます。

mutation {
  accountManagementCreateAccount(
    managedAccount: { name: "NEW_ACCOUNT_NAME", regionCode: "eu01" }
  ) {
    managedAccount {
      id
      name
      regionCode
    }
  }
}

アカウントの名前を変更する

アカウントの名前を変更する方法の例を次に示します。

mutation {
  accountManagementUpdateAccount(
    managedAccount: { name: "UPDATED_ACCOUNT_NAME", id: 101010101 }
  ) {
    managedAccount {
      id
      name
      regionCode
    }
  }
}

エラー

ここにいくつかのエラーとその意味があります：

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

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

アカウントを削除する

現在、NerdGraph を使用してアカウントを削除することはできません。代わりに、次の関連オプションを試してください。

• アカウントのダウングレードまたはキャンセル
• 監視対象エンティティを削除する