Tutoriel NerdGraph : afficher, créer, renommer ou annuler des comptes

Comme alternative à l'utilisation de l'UI de New Relic, vous pouvez utiliser NerdGraph pour afficher les comptes de votre organisation, ainsi que créer, renommer ou annuler des comptes.

Exigences

Pour connaître les exigences de gestion des paramètres au niveau de l'organisation via NerdGraph, voir Ajouter des comptes.

Avant de commencer

Avant d'utiliser NerdGraph pour gérer vos comptes, il vous sera probablement utile de comprendre :

• Que sont les comptes et à quoi servent-ils ?
• Que vous pouvez également gérer et ajouter des comptes via l'UI.
• Les bases de l'utilisation de NerdGraph
• Que vous pouvez suivre les modifications apportées à votre compte New Relic

Conseils sur les termes et les domaines

Quelques conseils sur certains champs utilisés dans ces requests:

• Les champs managedAccount et managedAccounts sont simplement des termes pour les comptes d'une organisation. Ils sont synonymes de « comptes ».
• Le champ regionCode fait référence au data center utilisé par un compte. Les valeurs valides sont us01 et eu01 qui correspondent respectivement aux régions des États-Unis et de l'UE.

Notez que l'explorateur NerdGraph dispose de documents intégrés qui définissent les champs.

Afficher les comptes

Voici un exemple de restitution des comptes de votre organisation :

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

Créer des comptes

Voici un exemple de création d'un compte. Avant de créer un compte, assurez-vous de bien comprendre à quoi sert un compte.

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

Si vous avez une structure de compte complexe, vous pouvez utiliser le paramètre facultatif regionCode pour cibler un data center spécifique.

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

Renommer un compte

Voici un exemple de comment renommer un compte.

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

Annuler un compte

Si vous ne souhaitez plus conserver un compte actif, vous pouvez l'annuler en utilisant NerdGraph.

Avant d’annuler un compte, examinez les effets de l’annulation d’un compte. Une fois que vous êtes sûr de vouloir annuler un compte, vous pouvez utiliser cette mutation :

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

Erreurs

Voici quelques erreurs et ce qu'elles signifient :

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

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