Compartir a través de

Obtención de una programación de migración a la nueva experiencia comercial

  • Artículo

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

En este artículo se describe cómo obtener una nueva programación de migración de comercio.

Importante

Esta API solo está disponible actualmente en el inquilino del espacio aislado.

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

Solicitud REST

Hay dos maneras diferentes en que los asociados pueden consultar.

  • Los asociados pueden consultar para obtener una programación determinada
  • Los asociados pueden consultar para obtener la lista de programaciones para criterios específicos

Sintaxis de la solicitud

Método URI de solicitud
GET {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID}

Parámetro de URI

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

Nombre Type Necesario Descripción
customer-tenant-id string Sí Cadena con formato de GUID que identifica al cliente.
Método URI de solicitud
GET {baseURL}/v1/migrations/newcommerce/schedules? CustomerTenantId={customer-tenant-id}

Parámetro de URI

En esta tabla se enumeran los parámetros de consulta necesarios para crear una nueva migración comercial. Se puede usar cualquiera del parámetro de consulta.

Nombre Tipo Descripción
customerTenantId string Cadena con formato de GUID que identifica al cliente.
currentSubscriptionID string Cadena con formato GUID que identifica el identificador de suscripción actual
externalReferenceID string Cadena con formato GUID que identifica el lote de migración

Encabezados de solicitud

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

Cuerpo de la respuesta

En esta tabla se describen las propiedades de la suscripción en la respuesta.

Propiedad Tipo Necesario Descripción
currentSubscriptionId string Sí Identificador de suscripción que indica qué suscripción requiere validación para la migración.
termDuration string No Duración del período aplicado a la migración.
billingCycle string No Ciclo de facturación aplicado a la migración.
purchaseFullTerm bool No Indica si la migración inicia un nuevo término o no.
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
targetDate datetime No Fecha de destino en la que se va a programar la migración.
migrateOnRenewal bool No Indica si la programación debe producirse durante la renovación.
status string No Estado de la migración de programación
createdTime datetime No Cuándo se creó la programación
lastModifiedTime datetime No Cuándo se modificó por última vez la programación

Respuesta REST

Si se ejecuta correctamente, este método devuelve detalles de las suscripciones que se migran (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 que la información de depuración es correcta o incorrecta. Use una herramienta de seguimiento de red para leer este código, tipo de error y más parámetros. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.

Ejemplos de respuesta

[
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00",
"createdTime": "2022-10-18T21:20:50.9668605+00:00",
"lastModifiedTime": "2022-10-18T21:29:32.8992819+00:00"
}
]

Consulte también