Crear una migración comercial

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

Creación de una migración de una suscripción a New Commerce Experience

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 Create Migration API es de 100 llamadas por un 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 HTTP/1.1

Parámetro de URI

En esta tabla se enumeran los parámetros de consulta necesarios para crear una nueva migración comercial.

Nombre	Type	Obligatorio	Descripción
customer-tenant-id	cadena	Sí	Cadena con formato de GUID que identifica al cliente.

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.
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

Ejemplo de solicitud

Tenga en cuenta que los complementos anidados (suscripciones de complementos con suscripciones de complementos) deben escribirse en el cuerpo de la solicitud como una lista plana dentro de addOnMigrations y no estar anidados dentro de otras suscripciones de complemento en la solicitud; consulte el último ejemplo de solicitud sobre cómo se pueden escribir los complementos en el cuerpo de la solicitud.

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

{ 
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "termDuration": "P1M", 
    "billingCycle": "Monthly", 
} 

{
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "purchaseFullTerm": true 
}

{
    "currentSubscriptionId": "66E738D6-E0BC-4FFB-8818-BDE99BC7008B",
    "quantity": 1,
    "billingCycle": "Annual",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "359011DC-B5B0-4660-850B-A8FA9B2E3309",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M"
        },
        {
            "currentSubscriptionId": "159D9F87-CE39-4EBD-B9C2-ECF0892A85A1",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y"
        }
    ]
}

Respuesta REST

Si se ejecuta correctamente, este método devuelve los detalles de las suscripciones que se van a migrar (objeto de migración) en el cuerpo de la respuesta.

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica el éxito o error y la información adicional de depuración. 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

{
    "addOnMigrations": [
        {
            "currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
            "customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "catalogItemId": "CFQ7TTC0LH0T:0001:CFQ7TTC0K4KQ",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "80906BD9-E45C-4D1B-92A8-EA3F3FB6E105",
            "customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "catalogItemId": "CFQ7TTC0LH0R:0001:CFQ7TTC0K0SK",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "72E424F4-10FF-4C76-B101-C274F73BA498",
            "customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "catalogItemId": "CFQ7TTC0LHXJ:0001:CFQ7TTC0KHTR",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        }
    ],
    "id": "7123c075-fc05-42d6-a21e-1d2036fa490b",
    "startedTime": "2022-02-23T13:00:48.4489832Z",
    "currentSubscriptionId": "2E56C7F5-E120-4CA4-BFF3-7DA763B4D777",
    "status": "Processing",
    "customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}