Tutorial de NerdGraph: ver, crear y cambiar el nombre de cuentas

Como alternativa al uso de la UIde New Relic, puede usar NerdGraph para ver las cuentas de su organización, crear cuentas y cambiarles el nombre.

Requisitos

Para conocer los requisitos para administrar la configuración a nivel de organización a través de NerdGraph, consulte Agregar cuentas.

Antes de que empieces

Antes de utilizar NerdGraph para administrar sus cuentas, probablemente le ayudará a comprender:

Qué son las cuentas y para qué sirven
Que también puedes administrar y agregar cuentas a través de la UI.
Los conceptos básicos del uso de NerdGraph
Que pueda realizar un seguimiento de los cambios en su cuenta New Relic

Este tutorial le mostrará cómo:

Ver cuentas
Cambiar el nombre de las cuentas
Agregar cuentas

Consejos sobre términos y campos

Algunos consejos sobre algunos de los campos utilizados en estas solicitudes:

Los campos managedAccount y managedAccounts son simplemente términos para las cuentas de una organización. Son sinónimos de "cuentas".
El campo regionCode hace referencia al centro de datos utilizado por una cuenta. Los valores válidos son us01 y eu01 , que se corresponden con las regiones de EE. UU. y UE, respectivamente.

Tenga en cuenta que el explorador NerdGraph tiene documentos integrados que definen campos.

Ver cuentas

A continuación se muestra un ejemplo de cómo devolver las cuentas de su organización:

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

Crear cuentas

A continuación se muestra un ejemplo de cómo crear una cuenta. Antes de crear una cuenta, asegúrese de comprender para qué se utiliza.

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

Si tiene una estructura de cuenta compleja, puede utilizar el parámetro opcional regionCode para apuntar a un centro de datos específico.

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

Cambiar el nombre de una cuenta

A continuación se muestra un ejemplo de cómo cambiar el nombre de una cuenta.

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

Errores

Aquí hay algunos errores y lo que significan:

Error message	Likely cause
`extensions: { nerdGraphExtensions: { errorClass: "ACCESS_DENIED" } } }`	Esto indica un problema con la estructura de su organización (por ejemplo, una cuenta que está fuera de los límites de una organización). Si recibe este mensaje, comuníquese con el soporte o con su representante de cuenta.
`cannot create subaccount -- multiple parent account ids found. Please use Partnership API.", { extensions: { nerdGraphExtensions: { errorClass: "SERVER_ERROR" } } }`	Este es un mensaje que se devuelve cuando su organización tiene más de una "cuenta principal", lo cual es un indicador de que su organización tiene una estructura de cuentas compleja que se configuró con la API de asociación y requiere el uso de esa API. ¿Tiene preguntas? Póngase en contacto con el soporte o con su representante de cuenta.
Otros errores	Póngase en contacto con el soporte o con su representante de cuenta.

Eliminar una cuenta

Actualmente no puedes eliminar cuentas usando NerdGraph. En su lugar, pruebe estas opciones relacionadas:

Te ofrecemos esta traducción automática para facilitar la lectura.