Obtención de una programación de migración a la nueva experiencia comercial
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 comercial.
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+user.
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 , 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
).Identificador de suscripción actual
Solicitud REST
Hay dos maneras diferentes en que los asociados pueden consultar.
- Para consultar una programación determinada
- Obtener la lista de programaciones de un criterio determinado
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 | Tipo | Obligatorio | 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.
Response body
En esta tabla se describen las propiedades de la suscripción en la respuesta.
Property | Tipo | Obligatorio | Descripción |
---|---|---|---|
currentSubscriptionId | string | Sí | Identificador de suscripción que indica qué suscripción requiere validación para la migración. |
termDuration | string | No | Se puede especificar la duración del período que se va a cambiar tras la migración. |
billingCycle | string | No | Se puede especificar el ciclo de facturación que se va a 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 | Una fecha de finalización se puede establecer para alinearse con una suscripción a OnlineServicesNCE o un mes natural que no sea de prueba. 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 los 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 si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. 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": "6f297517-16e6-4313-8c6d-4e10496d2871",
"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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta:Enviar y ver comentarios de