Objeto de suscripción de API de asociación

Este documento explica cómo utilizar la API de asociación para administrar la suscripción de cuentas en nuestro modelo de precios original.

Requisitos

The Partnership API is not available to your organization unless you're specifically instructed by your New Relic representative that you should use it.

Puede utilizar el objeto de suscripción solo si se encuentra en nuestro modelo de precios original. No admite cuentas con nuestro nuevo modelo de precios basado en el uso. Para obtener más información sobre esto, lea los requisitos de la API de asociación.

La API de asociación 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 suscripción del producto all para la cuenta.

Si alguna configuración de producto no está incluida, la API de New Relic Partnership proporciona a la cuenta el mejor tipo de producto gratuito disponible. La API selecciona automáticamente el nivel de producto según la configuración y los precios personalizados para la asociación de la cuenta.

Atributo de objeto de suscripción

Antes de usar esto, primero lea Requisitos.

Aquí están los atributos del objeto de suscripción:

Tipo:	Entero
Por defecto:	(ninguno)

El atributo product ID identifica el producto New Relic que se define para esta suscripción. Es required para Create llamadas.

Tipo:	Entero
Por defecto:	(ninguno)

El atributo quantity es required para Create llamadas, incluso si el nivel de un producto es ilimitado. La API ignorará el valor de cantidad ingresado para la suscripción ilimitada de productos, como New Relic APM Lite.

New Relic Insights, Browser y Sintéticos requieren que identifique un nivel de uso predefinido (grupo de productos). Esto permite que la API aplique un descuento en el precio según la cantidad específica que seleccione.

La cantidad que identifique debe coincidir exactamente con el producto y el nivel de suscripción. Para obtener una lista de los grupos de productos disponibles, consulte:

Tipo:	Cadena
Por defecto:	(ninguno)

Cualquier código promocional relacionado con esta suscripción.

Aún no es compatible a través de la suscripción extrema de Partnership API. Sin embargo, puede pasar el promo_code como parte de la suscripción con la llamada Create de la API de la cuenta.

Mapeo para productos (product_id)

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

Importante

Recuerde que el objeto de suscripción solo se aplica a cuentas que utilizan nuestro modelo de precios original.

Además, la API de asociación no admite la creación de suscripción para Serverless, log y traza. Si su cuenta tiene esta suscripción, cualquier intento de realizar cambios arrojará un error. Por favor contacte a su ejecutivo de cuenta para modificar la suscripción.

Importante

Los nuevos planes de servicio Startup y Small Business ya no están disponibles a través de la API de asociación de New Relic.

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 New Relic APM. Por ejemplo, New Relic 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, el precio 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 integer del ID del producto para identificar el nivel de suscripción y el tipo de plan.

APM subscription level	Product ID
Lite	1
Estándar	2
Estándar Anual	3
Pro (anfitrión)	4
Pro anual (anfitrión)	5
Empresa	6
Empresa Anual	7
APM Essentials (anfitrión)	8
Anual de APM Essentials (anfitrión)	9

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

APM Compute Units (CU) subscription level	Product ID
CU profesional	26
CU anual profesional	27
APM Essentials CU	28
CU anual de APM Essentials	29

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 integer del ID del producto para identificar el nivel de suscripción.

Mobile subscription level	Product ID
Lite	10
Empresa	13
Empresa Anual	14

New Relic Insights 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 Insights Free gratuita es un día). Tenga en cuenta que el atributodata_retention es obligatorio.

Insights subscription level	Product ID
Gratis	15
Ninguno	16
Pro	18
Pro Anual	19

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 integer del ID del producto para identificar el nivel de suscripción.
Browser subscription level
Product ID
Lite
20
Pro
21
Pro Anual
22

Browser subscription level	Product ID
Lite	20
Pro	21
Pro Anual	22

Con la estructura de precios del monitoreo sintético, la cantidad predeterminada de verificaciones de monitoreo permitidas y el período de retención de datos varían según el nivel de suscripción. Utilice el formato integer del ID del producto para identificar el nivel de suscripción.

Synthetics subscription level	Product ID
Lite	23
Pro	24
Pro Anual	25

Sugerencia

Si anteriormente utilizó la API de monitoreo de disponibilidad de la asociación obsoleta, puede usar la API de monitoreo sintético para proporcionar una verificación y la API REST para alertas para crear una notificación de alerta para sus clientes.

Con la estructura de precios de infraestructura de New Relic, el número predeterminado de instancias y el período de retención de datos varían según el nivel de suscripción. Infraestructura evento no cuentan contra tu cuota de New Relic Insights, aunque puedes consultarlos en Insights.

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

Infrastructure subscription level	Product ID
Infraestructura Ninguno	31
Infraestructura Pro (CU)	32
Infraestructura Pro Anual (CU)	33
Conceptos básicos de infraestructura (CU)	34
Anual de aspectos esenciales de infraestructura (CU)	35

Suscripción llamada API

Antes de usar esto, primero lea Requisitos.

Estos son los patrones de URL para las funciones API relacionadas con la suscripción. Si se utilizan, envíelos junto con el objeto JSON y un encabezado HTTP que contenga la clave de API del socio. Por ejemplo:

GET .../api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions
x-api-key:PARTNER_ACCOUNT_KEY
Content-Type: application/json

{ JSON data }

Llamar	Patrón de URL de recurso
List (índice) todas las suscripciones de una cuenta.	`GET /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions`
Show una suscripción para una cuenta.	`GET /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions/ID`
Replace el nivel de suscripción actual con una nueva suscripción.	`POST /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions`

Llamar

Patrón de URL de recurso

List (índice) todas las suscripciones de una cuenta.

GET /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions

Show una suscripción para una cuenta.

GET /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions/ID

Replace el nivel de suscripción actual con una nueva suscripción.

POST /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions

Ejemplos de API de suscripción

A continuación se muestran ejemplos de una API de llamada para crear una suscripción de modelo de precios original y la suscripción de listado de respuesta JSON para la cuenta.

{
  "id": 1069012,
  "starts_on": "2016-05-16",
  "expires_on": null,
  "annual_renewal_on": null,
  "products": [
  {
    "product_id": 4,
    "name": "Pro",
    "units": 2,
    "price": 218.0
  },
  {
    "product_id": 13,
    "name": "Mobile Enterprise",
    "units": 2,
    "price": 1500.0
  },
  {
    "product_id": 20,
    "name": "Browser Lite",
    "units": 0,
    "price": 0.0
  },
  {
    "product_id": 15,
    "name": "Insights Free",
    "units": 0,
    "price": 0.0
  },
  {
    "product_id": 23,
    "name": "Synthetics Lite",
    "units": 0,
    "price": 0.0
  },
  {
    "product_id": 31,
    "name": "Infrastructure None",
    "units": 0,
    "price": 0.0
  }
  ]
}

A continuación se muestran algunos valores de estado de suscripción del modelo de precios originales que la llamada API puede devolver.

Subscription status	Description
`pending`	El cliente se ha registrado para obtener un producto New Relic , pero el pago aún debe procesarse.
`authorized`	Se autorizó una tarjeta de crédito y se almacenó la clave de la bóveda, pero no se capturó el pago.
`free`	Esta suscripción es para un producto New Relic gratuito. No se requiere ningún procesamiento adicional.
`paid`	Se ha capturado un pago y se ha fijado la próxima fecha de pago.
`payment_declined`	El último intento de autorizar el pago fracasó.
`canceled`	La cuenta New Relic no tiene suscripción activa y no está activa. No se deben autorizar ni capturar ningún pago.
`replaced`	Esta suscripción ha sido reemplazada por otra suscripción a New Relic.

Ejemplos de API (v2)

A continuación, se muestran solicitudes y respuestas de ejemplo API para enumerar, mostrar, crear y actualizar la suscripción del modelo de precios original . Los saltos de línea en las respuestas son para facilitar la lectura. Las respuestas reales aparecen como una línea continua.

Request:

curl -X GET \
     -H 'x-api-key:PARTNER_ACCOUNT_KEY' \
     -H 'Content-Type:application/json' \
     https://rpm.newrelic.com/api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions

Response:

{
  "subscriptions": [
  {
    "id": :SUBSCRIPTION_ID,
    "starts_on": "2016-05-16",
    "expires_on": null,
    "annual_renewal_on": null,
    "products": [
    {
      "product_id": 1,
      "name": "Lite",
      "units": 0,
      "price": 0.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
  },
  {
    "product_id": 31,
    "name": "Infrastructure None",
    "units": 0,
    "price": 0.0
  }
  ]
}

Request:

curl -X GET \
     -H 'x-api-key:PARTNER_ACCOUNT_KEY' \
     -H 'Content-Type:application/json' \
     https://rpm.newrelic.com/api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions/SUBSCRIPTION_ID

Response:

{
  "id": :SUBSCRIPTION_ID,
  "starts_on": "2016-05-16",
  "expires_on": null,
  "annual_renewal_on": null,
  "products": [
  {
    "product_id": 1,
    "name": "Lite",
    "units": 0,
    "price": 0.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
  },
  {
    "product_id": 31,
    "name": "Infrastructure None",
    "units": 0,
    "price": 0.0
  }
  ]
}

A continuación se muestra un ejemplo de cómo utilizar la API de asociación para crear una nueva suscripción (reemplazar el nivel de suscripción existente para todos los productos) para la cuenta.

Request:

curl -X POST \
     -H 'x-api-key:PARTNER_ACCOUNT_KEY' \
     -H 'Content-Type:application/json' \
     -d '{"subscriptions":[{"product_id":"1", "quantity":1}]}' \
     https://rpm.newrelic.com/api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions

Response:

{
  "id": 1069068,
  "starts_on": "2016-05-16",
  "expires_on": null,
  "annual_renewal_on": null,
  "products": [
  {
    "product_id": 1,
    "name": "Lite",
    "units": 0,
    "price": 0.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
  },
  {
    "product_id": 31,
    "name": "Infrastructure None",
    "units": 0,
    "price": 0.0
  }
  ]
}

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

Objeto de suscripción de API de asociación

Requisitos

Atributo de objeto de suscripción

product_id (REQUERIDO para una nueva suscripción)

quantity (REQUERIDO para una nueva suscripción)

promo_code

data_retention (requerido sólo para Insights suscripción)

Mapeo para productos (product_id)

Importante

Importante

APM

Móvil

Insights

Browser

Sintético

Sugerencia

Infraestructura

Suscripción llamada API

Ejemplos de API de suscripción

Objeto de suscripción de ejemplo

Ejemplo de respuesta JSON

Estado de suscripción

Ejemplos de API (v2)

Lista

Espectáculo

Crear nueva (reemplazar suscripción existente)

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

Objeto de suscripción de API de asociación

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

Atributo de objeto de suscripción

quantity (REQUERIDO para una nueva suscripción)

promo_code

data_retention (requerido sólo para Insights suscripción)

Mapeo para productos (product_id)

Importante

Importante

APM

Móvil

Insights

Browser

Sintético

Infraestructura

Suscripción llamada API

Ejemplos de API de suscripción

Objeto de suscripción de ejemplo

Ejemplo de respuesta JSON

Estado de suscripción

Ejemplos de API (v2)

Lista

Espectáculo

Crear nueva (reemplazar suscripción existente)

Requisitos