Objeto de cuenta secundaria de API de asociación

Este documento explica cómo utilizar la API de asociación para administrar cuentas infantiles. Para las cuentas principales, usaría el objeto de cuenta .

Requisitos

Antes de utilizar esta API, tenga en cuenta:

Esta API no está disponible para usted a menos que un representante de New Relic le haya indicado a su organización que la use.
Es posible que no tenga acceso para utilizar este objeto API específico. Antes de usar, primero lea los requisitos.

Introducción al uso de cuentas infantiles

Algunas notas sobre el uso del objeto de cuenta infantil:

Para administrar cuentas principales o secundarias existentes, utilice el objeto de cuenta de la API de asociación.
Una cuenta principal puede tener más de una cuenta infantil asociada, pero cada cuenta infantil debe corresponder a una y solo una cuenta principal.
Cada cuenta infantil debe tener al menos un usuario primary_admin .
No puede crear una cuenta infantil sin conectarla a una cuenta principal existente y agregar al menos un usuario.

Atributo de objeto de cuenta infantil

Before using the Partnership API, first read the requirements.

Estos son los atributos del objeto de cuenta secundaria API de asociación:

Tipo:	Cadena
Por defecto:	(ninguno)

Este nombre debe ser único en la base de datos de New Relic. Si el nombre especificado no es único, se incrementará automáticamente con un sufijo numérico de la siguiente manera:

conflicting_name_1
conflicting_name_2
etc.

Tipo:	Booleano
Por defecto:	FALSO

Utilice esta bandera para indicar una cuenta de prueba. Se supone que las cuentas de prueba contienen datos basura y los sistemas internos las ignoran. Los datos que generan podrán ser eliminados en cualquier momento.

Tipo:	Matriz
Por defecto:	(ninguno)

Una matriz que define una lista de usuarios. Existen algunas restricciones dependiendo del estado de su cuenta:

Para asociaciones de clientes que han migrado su usuario a nuestro nuevo modelo de usuario más reciente: no defina usuario. Si agrega un usuario con este campo, será ignorado. En su lugar, para agregar un usuario, deberá utilizar estos procedimientos de administración de usuarios.
Para todas las demás cuentas, que tienen un usuario en nuestro modelo de usuario original: cuando crea la cuenta secundaria, puede definir solo un usuario: la cuenta Owner. Para agregar un usuario adicional, utilice el objeto de usuario API de asociación.
Para obtener más información sobre las restricciones, lea los Requisitos.

Para algunas New Relic organizaciones , las cuentas secundarias también se pueden crear a través de la página de la Account settings cuenta principal en la New Relic UI.

API de llamada de cuenta infantil

Aquí está el patrón de URL para crear cuentas infantiles. Tenga en cuenta que se debe especificar el ID de la cuenta principal. Si utiliza este patrón de URL, envíe el objeto JSON junto con un encabezado HTTP que contenga la clave de API del socio. Por ejemplo:

POST .../api/v2/partners/PARTNER_ID/accounts/PARENT_ACCOUNT_ID/sub_accounts
x-api-key:PARTNER_ACCOUNT_KEY
Content-Type: application/json

{ JSON data }

Llamar	Patrón de URL de recurso
Create una cuenta infantil con el parámetro dado.	`POST /api/v2/partners/PARTNER_ID/accounts/PARENT_ACCOUNT_ID/sub_accounts`

Ejemplo JSON

A continuación se muestra un ejemplo de una solicitud y respuesta JSON utilizando el objeto de cuenta secundaria de Partnership API.

Note that this is just an example, and that for some accounts, the users attribute is unnecessary and will be ignored.

{
  "sub_account": {
    "name": "Sample child account",
    "allow_api_access": true
  },
  "users": [
    {
      "email": "sample_user@sample.org",
      "password": "XXXXXXXX",
      "first_name": "Sample",
      "last_name": "User",
      "role": "admin",
      "owner": "true"
    }
  ]
}

{
  "id": XXXXXX,
  "name": "Sample Account",
  "status": "pending",
  "license_key": "XXXXXX",
  "api_key": "XXXXXX",
  "browser_monitoring_key": "XXXXXX",
  "allow_api_access": true,
  "high_security": false,
  "testing": null,
  "partner_external_identifier": null,
  "parent_account_id":XXXXXX,
  "subscription": {
    "id": XXXXXX,
    "starts_on": "2016-05-17",
    "expires_on": null,
    "annual_renewal_on": null,
    "products": [
      {
        "product_id": 4,
        "name": "Pro",
        "units": 10,
        "price": 1990.0
      },
      {
        "product_id": 10,
        "name": "Mobile Lite",
        "units": 0,
        "price": 0.0
      },
      {
        "product_id": 20,
        "name": "Browser Lite",
        "units": 0,
        "price": 0.0
      },
      {
        "product_id": 16,
        "name": "Insights None",
        "units": 0,
        "price": 0.0
      },
      {
        "product_id": 23,
        "name": "Synthetics Lite",
        "units": 0,
        "price": 0.0
      }
    ]
  },
  "primary admin": {
    "id": XXXXXX,
    "email": "sample_user@sample.org",
    "first_name": "Sample",
    "last_name": "User",
    "state": "active"
  }
}

Ejemplos de API de objetos de cuentas infantiles

A continuación se muestra un ejemplo de una llamada API que utiliza el objeto de cuenta secundaria de Partnership API.

Note that this is just an example, and that for some accounts, the users attribute is unnecessary and will be ignored.

Pedido:

curl -X POST \
-H 'x-api-key:PARTNER_ACCOUNT_KEY' \
-H 'Content-Type:application/json' \
-d '{"sub_account":{"name":"Sample child account"}, "users":[{"email":"sample_user@sample.org", "password":"XXXXXX", "first_name":"Sample", "last_name":"User", "role":"admin", "owner":"true"}]}' \
https://rpm.newrelic.com/api/v2/partners/PARTNER_ID/accounts/PARENT_ACCOUNT_ID/sub_accounts

Respuesta (los saltos de línea son para facilitar la lectura):

{
  "id": XXXXXX,
  "name": "Sample child account",
  "status": "pending",
  "license_key": "XXXXXX",
  "api_key": "XXXXXX",
  "browser_monitoring_key": "XXXXXX",
  "allow_api_access": false,
  "high_security": false,
  "testing": null,
  "partner_external_identifier": null,
  "parent_account_id":XXXXXX,
  "subscription": {
    "id": XXXXXX,
    "starts_on": "2016-05-17",
    "expires_on": null,
    "annual_renewal_on": null,
    "products": [
      {
        "product_id": 4,
        "name": "Pro",
        "units": 10,
        "price": 1999.0
      },
      {
        "product_id": 10,
        "name": "Mobile Lite",
        "units": 0,
        "price": 0.0
      },
      {
        "product_id": 20,
        "name": "Browser Lite",
        "units": 0,
        "price": 0.0
      },
      {
        "product_id": 16,
        "name": "Insights None",
        "units": 0,
        "price": 0.0
      },
      {
        "product_id": 23,
        "name": "Synthetics Lite",
        "units": 0,
        "price": 0.0
      }
    ]
  },
  "primary admin": {
    "id": XXXXXX,
    "email": "sample_user@sample.org",
    "first_name": "Sample",
    "last_name": "User",
    "state": "active"
  }
}

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

Objeto de cuenta secundaria de API de asociación

Requisitos

Introducción al uso de cuentas infantiles

Atributo de objeto de cuenta infantil

Nombre (requerido)

allow_api_access

pruebas

usuario (REQUERIDO para algunas cuentas)

Se requiere contraseña)

API de llamada de cuenta infantil

Ejemplo JSON

Solicitud JSON de objeto de cuenta infantil

Respuesta JSON

Ejemplos de API de objetos de cuentas infantiles

Crear

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

Objeto de cuenta secundaria de API de asociación

Requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Introducción al uso de cuentas infantiles

Atributo de objeto de cuenta infantil

allow_api_access

pruebas

usuario (REQUERIDO para algunas cuentas)

Se requiere contraseña)

API de llamada de cuenta infantil

Ejemplo JSON

Solicitud JSON de objeto de cuenta infantil

Respuesta JSON

Ejemplos de API de objetos de cuentas infantiles

Crear

Requisitos