Compartir a través de

Crear una migración comercial

Se aplica a: Centro de asociados | Centro de asociados operado por 21Vianet | Centro de asociados para la Nube de Microsoft para el Gobierno de los EE. UU.

Cómo crear una migración de una suscripción a New Commerce Experience

Prerrequisitos

  • Credenciales tal como se describe en Autenticación del Centro de asociados. 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 Partner Center 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 ID de cliente (customer-tenant-id).

  • Un ID de suscripción actual

Límite de velocidad

El límite de Create Migration API es de 100 llamadas de un partner en 5 minutos. Para obtener más información sobre los límites de velocidad y la limitación, consulte Guía de limitación de API.

Solicitud REST

Sintaxis de la solicitud

Método Solicitud de URI
EXPONER {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 Tipo Obligatorio Descripción
identificación de cliente-inquilino cuerda / cadena Sí Cadena con formato GUID que identifica al cliente.

Cabeceras de solicitud

Para más información, consulte 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 Tipo Obligatorio Descripción
currentSubscriptionId cuerda / cadena Sí Identificador de suscripción que indica qué suscripción requiere validación para la migración.
termDuration cuerda / cadena No La duración del plazo se puede cambiar durante la migración.
BillingCycle cuerda / cadena No El ciclo de facturación se puede cambiar durante la migración.
purchaseFullTerm booleano No Se puede iniciar un nuevo término en NCE después de la migración.
cantidad Int No La cantidad de licencias de una suscripción se puede aumentar o disminuir durante la migración.
customTermEndDate fecha y hora No Se puede establecer una fecha de finalización para que coincida con una suscripción existente de OnlineServicesNCE que no sea de prueba o con un mes calendario. 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 anidarse dentro de otras suscripciones de complementos en la solicitud; Consulte el último ejemplo de solicitud para saber 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 realiza correctamente, este método devuelve detalles de las suscripciones que se van a migrar (objeto de migración) en el cuerpo de la respuesta.

Códigos de éxito y de error de la respuesta

Cada respuesta viene con un código de estado HTTP que indica éxito o fracaso e información de depuración adicional. Utilice una herramienta de seguimiento de red para leer este código, el tipo de error y otros parámetros. Para obtener la lista completa, consulta Códigos de error de REST del Centro de socios.

Ejemplos de respuesta

{
    "addOnMigrations": [
        {
            "currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}