Compartir a través de

Validar una suscripción para la migración

  • Artículo

Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government

Validación de una suscripción para la migración a Nueva experiencia comercial

Requisitos previos

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con credenciales de aplicación independiente y app+usuario.

  • Un id. de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners seleccionando el área de trabajo Clientes , luego el cliente de la lista de clientes y, a continuación , Cuenta. En la página Cuenta del cliente, busca el Id. de Microsoft en la sección Información de la cuenta del cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id).

  • Un identificador de suscripción actual

Límite de frecuencia

El límite de Validate Migration API es de 450 llamadas por combinación de cliente asociado en 5 minutos. Puede encontrar más información sobre los límites de velocidad y la limitación en la guía de limitación de API.

Solicitud REST

Sintaxis de la solicitud

Método URI de solicitud
POST {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/validate HTTP/1.1

Parámetro de URI

En esta tabla se enumeran los parámetros de consulta necesarios para validar una suscripción para la migración.

Nombre Type Obligatorio Descripción
customer-tenant-id string Sí Cadena con formato de GUID que identifica al cliente.
termDuration string No La duración del término se puede cambiar tras la migración.
billingCycle string No El ciclo de facturación se puede cambiar tras la migración.
purchaseFullTerm bool No Se puede iniciar un nuevo término en NCE tras la migración.
cantidad int No La cantidad de licencias de una suscripción se puede aumentar o disminuir tras la migración.
customTermEndDate datetime No Se puede establecer una fecha de finalización para alinearse con una suscripción a OnlineServicesNCE existente o un mes natural. Hay más información sobre cómo alinear las fechas de finalización de la suscripción aquí: Alinear las fechas de finalización de la suscripción en el Centro de partners

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

En esta tabla se describen las propiedades de suscripción en el cuerpo de la solicitud.

Propiedad Type Obligatorio Descripción
currentSubscriptionId string Sí Identificador de suscripción que indica qué suscripción requiere validación para la migración.

Ejemplo de solicitud

"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"

Respuesta REST

Si se ejecuta correctamente, este método devuelve un valor booleano "isEligible" en el cuerpo de la respuesta, lo que indica si la suscripción actual es apta para la migración a un nuevo comercio. Nota: Validate Migration API no proporciona información sobre la idoneidad de una suscripción para promociones en New Commerce.

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica la información de depuración correcta o incorrecta y extral. Use una herramienta de seguimiento de red para leer este código, tipo de error y otros parámetros. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.

Ejemplos de respuesta

1. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": false,
        "errors": [
            {
                "code": 5,
                "description": "Subscription cannot be migrated to New Commerce because the equivalent offer is not yet available in New Commerce",
            }
        ]
    }

2. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": true,
        "catalogItemId": "CFQ7TTC0LF8S:0002:CFQ7TTC0KSVV"
    }