Tutorial de NerdGraph: Suscripción de socio y revendedor

La funcionalidad de aprovisionamiento de suscripción de nuestra API NerdGraph le permite, como socio de New Relic, crear una suscripción para sus cuentas. Y le brinda acceso a una gama más amplia de productos New Relic que la API de socio.

Requisitos

No debe utilizar NerdGraph para ajustar el aprovisionamiento de su suscripción a menos que su representante de New Relic se lo indique específicamente.
Solo disponible para cuentas de socios que se encuentran en nuestro modelo de precios original.

La funcionalidad de aprovisionamiento de NerdGraph y la API de asociación son compatibles cuando se trata de los productos soportados por ambos (APM, Mobile, información valiosa, browser, Sintético e infraestructura). Si usa NerdGraph para crear una suscripción para cualquiera de los productos más nuevos, ya no podrá actualizar la cuenta usando la API de asociación.

Empezar: extremo y clave de API

Para conocer los conceptos básicos de NerdGraph, consulte Introducción a NerdGraph.

La funcionalidad de aprovisionamiento de NerdGraph utiliza una mutación llamada organizationProvisioningUpdatePartnerSubscription. A continuación se muestra una solicitud de ejemplo que realiza cambios de suscripción en una cuenta específica:

curl -v -d'{"query": "mutation { organizationProvisioningUpdatePartnerSubscription(accountId: PARTNER_ACCOUNT_ID, affectedAccountId: ACCOUNT_ID, 
products: [{id: 9200, name: \"Traces\", unitsOfMeasure: [{unit: SPANS_IN_MILLIONS, quantity: 40}]}]) {enqueued errors {message path } } }"}' -H'Content-type: application/json' -H'Api-key: YOUR_USER_KEY' https://api.newrelic.com/graphql

Suscripción de producto para una cuenta

NerdGraph no le permite actualizar o degradar la suscripción de un producto individual para una cuenta. En cambio, la API requiere que reemplace (agregue) la configuración de todas las suscripciones de productos para la cuenta.

Sugerencia

Si alguna configuración del producto no está incluida, NerdGraph proporciona automáticamente a la cuenta un producto gratuito (cuando esté disponible).

Mapeo para productos (productId)

Con cada llamada de creación de cuenta, debe proporcionar al menos un tipo de producto New Relic. La consulta de mutación solo acepta el número productId para el tipo.

La cantidad de hosts permitidos por cuenta y el período de retención de datos varían según el nivel de suscripción dentro de la estructura de precios de APM. Por ejemplo, APM permite una cantidad ilimitada de hosts permitidos para cuentas Lite, pero solo un período de retención de datos de 24 horas.

Además, los precios y la retención de datos dependen de si selecciona modelos de precios basados en hosts o unidades de computación (CU). Utilice el formato entero del ID del producto para identificar el nivel de suscripción y el tipo de plan.

Nivel de suscripción	`products.id`	`unitsOfMeasure.unit`
Lite	18	No aplica
Estándar	41	`HOSTS`
Estándar Anual	38	`HOSTS`
Pro (anfitrión)	42	`HOSTS`
Pro anual (anfitrión)	39	`HOSTS`
Empresa	43	`HOSTS`
Empresa Anual	40	`HOSTS`

Si selecciona modelos de precios basados en unidad de computación (CU), utilice estos formatos de números enteros de ID de producto para identificar el nivel de suscripción y el tipo de plan.

Nivel de suscripción	`products.id`	`unitsOfMeasure.unit`
CU profesional	126	`COMPUTE_UNIT`
CU anual profesional	127	`COMPUTE_UNIT`
APM Essentials CU	128	`COMPUTE_UNIT`
CU anual de APM Essentials	129	`COMPUTE_UNIT`

Solicitudes de ejemplo

APM Pro con 5 hosts

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: :PARTNER_ACCOUNT_ID,
    affectedAccountId: :ACCOUNT_ID,
    products: [
      {
        id: 42,
        unitsOfMeasure: [
          {
            unit: HOSTS,
            quantity: 5
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

APM Pro CU con 3000 unidades de computación

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 126,
        unitsOfMeasure: [
          {
            unit: COMPUTE_UNIT,
            quantity: 3000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

La estructura de precios de New Relic Mobile permite 100.000 usuarios activos mensuales por cuenta en el nivel de suscripción Enterprise. La retención de datos varía según el nivel de suscripción. Utilice el formato entero del ID del producto para identificar el nivel de suscripción.

Nivel de suscripción	`products.id`	`unitsOfMeasure.unit.1`	`unitsOfMeasure.unit.2`
Lite	49	No aplica	No aplica
Empresa	54	`APPS`	`USERS`
Empresa Anual	55	`APPS`	`USERS`

Solicitud de ejemplo

Empresa móvil con 1 aplicación y 100 000 usuarios activos mensuales

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 54,
        unitsOfMeasure: [
          {
            unit: APPS,
            quantity: 1
          },
          {
            unit: USERS,
            quantity: 100000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

New Relic información valiosa basa la estructura de precios en la cantidad de eventos permitidos almacenados y la política de retención de datos asociada. Por ejemplo, la retención de datos para información valiosa gratuita es de un día.

Nivel de suscripción	`products.id`	`unitsOfMeasure.unit.1`	`unitsOfMeasure.unit.2`
Gratis	67	No aplica	No aplica
Ninguno	65	No aplica	No aplica
Pro	66	`DATA_RETENTION_IN_DAYS`	`EVENTS_IN_MILLIONS`
Pro Anual	69	`DATA_RETENTION_IN_DAYS`	`EVENTS_IN_MILLIONS`

Solicitud de ejemplo

Información valiosa Pro con 7 días de retención de datos y 25 millones de eventos

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 66,
        unitsOfMeasure: [
          {
            unit: DATA_RETENTION_IN_DAYS,
            quantity: 7
          },
          {
            unit: EVENTS_IN_MILLIONS,
            quantity: 25
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

La estructura de precios de New Relic Browser permite un número ilimitado de usuarios de la aplicación, independientemente del nivel de suscripción. Sin embargo, la cantidad de visitas a la página permitidas por mes y el período de retención de datos varían según el nivel de suscripción. Por ejemplo:

Las cuentas Lite incluyen una cantidad ilimitada de páginas vistas por mes y retención de datos las 24 horas.

El precio de la cuenta Pro comienza en 500.000 páginas vistas por mes y tres meses de retención de datos.

Utilice el formato entero del ID del producto para identificar el nivel de suscripción.

Nivel de suscripción	`products.id`	`unitsOfMeasure.unit`
Lite	76	No aplica
Pro	72	`PAGE_VIEWS`
Pro Anual	73	`PAGE_VIEWS`

Solicitud de ejemplo

Browser Pro con 500.000 páginas vistas

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 42,
        unitsOfMeasure: [
          {
            unit: PAGE_VIEWS,
            quantity: 500000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Con la estructura de precios de New Relic Synthetics, la cantidad predeterminada de comprobaciones de monitoreo permitidas y el período de retención de datos varían según el nivel de suscripción. Utilice el formato entero del ID del producto para identificar el nivel de suscripción.

Nivel de suscripción	`products.id`	`unitsOfMeasure.unit.1`
Lite	81	No aplica
Pro	77	`CHECKS`
Pro Anual	78	`CHECKS`

Solicitud de ejemplo

Synthetics Pro con 10.000 verificaciónes

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 77,
        unitsOfMeasure: [
          {
            unit: CHECKS,
            quantity: 10000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Con la estructura de precios de New Relic Infrastructure, el número predeterminado de instancias y el período de retención de datos varían según el nivel de suscripción. Los eventos de infraestructura no cuentan para tu cuota de información valiosa de New Relic, aunque puedes consultarlos en información valiosa.

New Relic Infrastructure ofrece modelos de precios basados únicamente en unidades de computación (CU). Utilice el formato entero del ID del producto para identificar el nivel de suscripción.

Nivel de suscripción	`products.id`	`unitsOfMeasure.unit`
Infraestructura Ninguno	142	No aplica
Infraestructura Pro (CU)	134	`COMPUTE_UNIT`
Infraestructura Pro Anual (CU)	135	`COMPUTE_UNIT`
Conceptos básicos de infraestructura (CU)	136	`COMPUTE_UNIT`
Anual de aspectos esenciales de infraestructura (CU)	137	`COMPUTE_UNIT`

Solicitud de ejemplo

Infraestructura Pro con 5,000 unidades de computación

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 134,
        unitsOfMeasure: [
          {
            unit: COMPUTE_UNIT,
            quantity: 5000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Nivel de suscripción	`products.id`	`unitsOfMeasure.unit.1`
Anual sin servidor	9010	`INGESTED_EVENTS`
Mensual sin servidor	9000	`INGESTED_EVENTS`

Solicitud de ejemplo

Serverless Monthly con 3000 eventos ingeridos en millones

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 9000,
        unitsOfMeasure: [
          {
            unit: INGESTED_EVENTS,
            quantity: 3000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Nivel de suscripción	`products.id`	`unitsOfMeasure.unit.1`
Traza anual	9200	`SPANS_IN_MILLIONS`
Traza mensual	9210	`SPANS_IN_MILLIONS`

Solicitud de ejemplo

Traza Anual con 3.000 vanos en millones

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 9200,
        unitsOfMeasure: [
          {
            unit: SPANS_IN_MILLIONS,
            quantity: 3000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Nivel de suscripción	`products.id`	`unitsOfMeasure.unit.1`
Logs compromiso anual - 8 días	9110	`GB_PER_DAY`
Logs compromiso anual - 15 días	9111	`GB_PER_DAY`
Logs compromiso anual - 30 días	9112	`GB_PER_DAY`
Logs compromiso mensual - 8 días	9100	`GB_PER_DAY`
Logs compromiso mensual - 15 días	9101	`GB_PER_DAY`
Logs compromiso mensual - 30 días	9102	`GB_PER_DAY`

Solicitud de ejemplo

Logs con retención de datos de 8 días y 100 Gigabytes por día

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 9100,
        unitsOfMeasure: [
          {
            unit: GB_PER_DAY,
            quantity: 100
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Nivel de suscripción	`products.id`	`unitsOfMeasure.unit.1`
Compromiso Anual métrica	9310	`DPM`
Compromiso Mensual métrica	9300	`DPM`

Solicitud de ejemplo

Compromiso mensual de métrica con 50 puntos de datos por minuto

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 9300,
        unitsOfMeasure: [
          {
            unit: DPM,
            quantity: 50
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Tipos de GraphQL

La funcionalidad de aprovisionamiento de NerdGraph utiliza los siguientes tipos de GraphQL:

Nombre	Tipo	Descripción
`account_id`	Entero	ID numérico de la cuenta de socio de la sociedad a la que pertenece la cuenta afectada.
`affected_account_id`	Entero	ID numérico de la cuenta a la que se aplicarán los cambios descritos en el campo de productos.
`products`	Matriz de Producto	Colección de tipo Producto que representa los valores que compondrán la nueva suscripción de la Cuenta Afectada.

Nombre	Tipo	Descripción
`Id`	Entero	ID numérico del Producto que se agregará a la suscripción.
`Name`	Cadena	Nombre del Producto que se agregará a la suscripción.
`Unit of Measure`	Matriz de unidad de medida	Colección de tipo Unidad de medida para este único producto.

Nombre	Tipo	Descripción
`quantity`	Entero	Valor numérico de la cantidad de unidades a aplicar a la suscripción.
`unit`	Cadena	Nombre de la unidad que se aplicará al producto (varía según la línea de producto).

Ejemplos

A continuación se muestran ejemplos de una llamada API para crear una suscripción y la respuesta JSON.

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 9410,
        unitsOfMeasure: [{unit: INCIDENT_EVENTS, quantity: 50}]
      },
      {
        id: 42,
        unitsOfMeasure: [{unit: HOSTS, quantity: 5 }]
      },
      {
        id: 42,
        unitsOfMeasure: [{unit: PAGE_VIEWS, quantity: 500000}]
      },
      {
        id: 134,
        unitsOfMeasure: [{unit: COMPUTE_UNIT, quantity: 5000}]
      },
      {
        id: 66,
        unitsOfMeasure: [
          {unit: DATA_RETENTION_IN_DAYS, quantity: 7 },
          {unit: EVENTS_IN_MILLIONS, quantity: 25 }
        ]
      },
      {
        id: 9100,
        unitsOfMeasure: [{unit: GB_PER_DAY, quantity: 100 } ]
      },
      {
        id: 9300,
        unitsOfMeasure: [{unit: DPM, quantity: 50 }
        ]
      },
      {
        id: 54,
        unitsOfMeasure: [
          {unit: APPS, quantity: 1 },
          {unit: USERS, quantity: 100000 }
        ]
      },
      {
        id: 9000,
        unitsOfMeasure: [{unit: INGESTED_EVENTS, quantity: 3000 } ]
      },
      {
        id: 77,
        unitsOfMeasure: [{unit: CHECKS, quantity: 10000 } ]
      },
      {
        id: 9200,
        unitsOfMeasure: [{unit: SPANS_IN_MILLIONS, quantity: 3000 } ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Esta consulta devuelve lo siguiente:

{
  "data": {
    "organizationProvisioningUpdatePartnerSubscription": {
      "enqueued": true,
      "errors": []
    }
  }
}

mutation {
    organizationProvisioningUpdatePartnerSubscription (
      accountId: :PARTNER_ACCOUNT_ID,
      affectedAccountId: :ACCOUNT_ID,
      products: [
        {
          id: 9110,
          unitsOfMeasure: [
            {
              unit: GB_PER_DAY,
              quantity: 100
            },
            {
              unit: DATA_RETENTION_IN_DAYS,
              quantity: 8
            }

          ]
        }
      ]
    ) {
      enqueued
      errors {
        message
        path
      }
  }
}

Esta consulta devuelve lo siguiente:

{
  "data": {
    "organizationProvisioningUpdatePartnerSubscription": {
      "enqueued": true,
      "errors": []
    }
  }
}

Response: Una vez que NerdGraph haya recibido su solicitud y haya validado que está en el formato correcto, responderá con un mensaje como este. Esto no significa que su mensaje haya sido procesado o aplicado exitosamente; pero se validó que tenía el formato correcto y se puso en cola para su procesamiento.

{
  "data": {
    "organizationProvisioningUpdatePartnerSubscription": {
      "enqueued": true,
      "errors": []
    }
  }
}

Variaciones de la API de asociación

Estas son algunas diferencias clave entre la funcionalidad de aprovisionamiento de NerdGraph y la API de socios que los usuarios frecuentes de API de socios deben conocer:

Característica	Descripción
Clave de API	NerdGraph usa un . La API de socio utiliza la clave de API de socio.
`productId` y `product_id`	Los ID de producto de NerdGraph son diferentes a los utilizados para la API de asociación.
Formato de solicitud de curl	Para realizar una solicitud curl a NerdGraph, el formato será diferente al de la API de asociación: El extremo de la URL es diferente. La clave de API requerida es su clave de API personal NerdGraph responde sólo a solicitudes HTTP POST
Las `INGESTED_EVENTS` unidades sin servidor están en millones	El envío de `unitsOfMeasure: [{unit: INGESTED_EVENTS, quantity: 3000 } ]` será interpretado por NerdGraph como un evento de 3.000 millones.
Información valiosa y Móvil requieren 2 unidades de medida	La información valiosa requiere `DATA_RETENTION_IN_DAYS` y `EVENTS_IN_MILLIONS` Móvil requiere `APPS` y `USERS`.
La unidad de medida de retención de datos de registro está determinada por el ID del producto.	Esto se especifica en el nombre del producto: Logs compromiso anual - 8 días \| ID del producto: 9110 Logs compromiso anual - 15 días \| ID del producto: 9111 Logs compromiso anual - 30 días \| ID del producto: 9112 Logs compromiso mensual - 8 días \| ID del producto: 9100 Logs compromiso mensual - 15 días \| ID del producto: 9101 Logs compromiso mensual - 30 días \| ID del producto: 9102

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

Tutorial de NerdGraph: Suscripción de socio y revendedor

Requisitos

Empezar: extremo y clave de API

Suscripción de producto para una cuenta

Sugerencia

Mapeo para productos (productId)

APM

Solicitudes de ejemplo

Móvil

Solicitud de ejemplo

Insights

Solicitud de ejemplo

Browser

Solicitud de ejemplo

Sintético

Solicitud de ejemplo

Infraestructura

Solicitud de ejemplo

Sin servidor para Lambda

Solicitud de ejemplo

Traza

Solicitud de ejemplo

Registro

Solicitud de ejemplo

Métrica

Solicitud de ejemplo

Tipos de GraphQL

Suscripción

Producto

Unidad de medida

Ejemplos

Crear (reemplazar suscripción existente) con muchos productos

Crear (reemplazar la existente) suscripción con un producto - iniciar sesión

Variaciones de la API de asociación

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

Tutorial de NerdGraph: Suscripción de socio y revendedor

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

Empezar: extremo y clave de API

Suscripción de producto para una cuenta

Sugerencia

Mapeo para productos (productId)

Móvil

Insights

Browser

Sintético

Infraestructura

Sin servidor para Lambda

Traza

Registro

Métrica

Tipos de GraphQL

Suscripción

Producto

Unidad de medida

Ejemplos

Crear (reemplazar suscripción existente) con muchos productos

Crear (reemplazar la existente) suscripción con un producto - iniciar sesión

Variaciones de la API de asociación

Requisitos