Tutorial do NerdGraph: visualizar, criar e renomear contas

Como alternativa ao uso da interface New Relic, você pode usar o NerdGraph para visualizar as contas da sua organização, criar contas e renomear contas.

Requisitos

Para requisitos para gerenciar configurações em nível de organização via NerdGraph, consulte Adicionar contas.

Antes que você comece

Antes de usar o NerdGraph para gerenciar suas contas, provavelmente irá ajudá-lo a entender:

O que são contas e para que servem
Que você também pode gerenciar e adicionar contas por meio da interface.
Os princípios básicos do uso do NerdGraph
Que você pode acompanhar as alterações em sua conta New Relic

Este tutorial mostrará como:

Ver contas
Renomear contas
Adicionar contas

Dicas sobre termos e campos

Algumas dicas sobre alguns dos campos utilizados nessas solicitações:

Os campos managedAccount e managedAccounts são simplesmente termos para as contas de uma organização. Eles são sinônimos de “contas”.
O campo regionCode refere-se ao data center usado por uma conta. Os valores válidos são us01 e eu01 , que mapeiam as regiões dos EUA e da UE, respectivamente.

Observe que o NerdGraph Explorer possui documentos integrados que definem os campos.

Ver contas

Aqui está um exemplo de devolução de contas em sua organização:

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

Criar contas

Aqui está um exemplo de como criar uma conta. Antes de criar uma conta, certifique-se de entender para que serve uma conta.

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

Se você tiver uma estrutura de conta complexa, poderá usar o parâmetro opcional regionCode para destinar um data center específico.

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

Renomear uma conta

Aqui está um exemplo de como renomear uma conta.

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

Erros

Aqui estão alguns erros e o que eles significam:

Error message	Likely cause
`extensions: { nerdGraphExtensions: { errorClass: "ACCESS_DENIED" } } }`	Isso indica um problema na estrutura da sua organização (por exemplo, uma conta que está fora dos limites de uma organização). Se você receber esta mensagem, entre em contato com o suporte ou com seu representante de conta.
`cannot create subaccount -- multiple parent account ids found. Please use Partnership API.", { extensions: { nerdGraphExtensions: { errorClass: "SERVER_ERROR" } } }`	Esta é uma mensagem retornada quando sua organização tem mais de uma "conta pai", o que é um indicador de que sua organização tem uma estrutura de conta complexa que foi configurada com a API de Parceria e requer o uso dessa API. Tem perguntas? Contate o suporte ou seu representante de conta.
Outros erros	Contate o suporte ou seu representante de conta.

Excluir uma conta

Atualmente você não pode excluir contas usando NerdGraph. Em vez disso, tente estas opções relacionadas:

Esta tradução de máquina é fornecida para sua comodidade.