Tutorial do NerdGraph: visualizar, criar, renomear ou cancelar contas

Como alternativa ao uso da interface New Relic , você pode usar o NerdGraph para visualizar as contas da sua organização, bem como criar, renomear ou cancelar 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

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

Cancelar uma conta

Caso não queira mais manter uma conta ativa, você pode cancelá-la usando o NerdGraph. A opção de cancelar uma conta está disponível apenas no NerdGraph. Você não pode cancelar uma conta na interface.

Antes de cancelar uma conta, analise os efeitos do cancelamento de uma conta. Quando tiver certeza de que deseja cancelar uma conta, você pode usar esta mutação:

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

Erros

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

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

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