Validar una suscripción para la migración

Artículo
10/14/2023

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	cadena	Sí	Cadena con formato de GUID que identifica al cliente.
termDuration	cadena	No	La duración del término se puede cambiar tras la migración.
billingCycle	cadena	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.
quantity	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	cadena	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"
    }

Share via