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
    }
  }
}

アカウントをキャンセルする

アカウントをアクティブに維持する必要がなくなった場合は、NerdGraph を使用してキャンセルできます。 アカウントをキャンセルするオプションは NerdGraph でのみ利用可能です。 UI でアカウントをキャンセルすることはできません。

アカウントをキャンセルする前に、アカウントをキャンセルした場合の影響を確認してください。 アカウントをキャンセルしたいことが確定したら、次のミューテーションを使用できます。

mutation {
  accountManagementCancelAccount(id: $accountId) {
    id
    isCanceled
    name
    regionCode
  }
}

エラー

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

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

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