Programación de una migración comercial nueva
Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government
Roles adecuados: Agente de administración | Agente de ventas
En este artículo se describe cómo programar una nueva experiencia comercial.
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
Método | URI de solicitud |
---|---|
POST | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules |
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. |
Para obtener más información, consulta Encabezados REST del Centro de partners.
En esta tabla se describen las propiedades de la suscripción en el cuerpo de la solicitud.
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 | Se puede especificar la duración del término 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. |
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 | Obligatorio (si migrateOnRenewal es null/false) | Fecha de destino en la que se va a programar la migración. Si targetDate se establece para la fecha especificada, migrationOnRenewal se puede establecer en null o false. |
migrateOnRenewal | bool | Obligatorio (si targetDate es null) | Si la marca se establece en true para migrateOnRenewal, no es necesario especificar targetDate para programar una migración. |
addOnMigrationSchedules | bool | No | Incluye una lista de suscripciones de AddOn que se incluirán en la migración programada. |
{
"currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
"quantity": 1,
"billingCycle": "monthly",
"purchaseFullTerm": false,
"termDuration": "P1Y",
"customTermEndDate": null,
"targetDate": "2023-08-09T00:00:00.000Z",
"addOnMigrations": [
{
"currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
"quantity": 17,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1M",
"customTermEndDate": null
},
{
"currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
"quantity": 23,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1Y",
"customTermEndDate": null
}
]
}
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.
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.
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
"quantity": 1,
"billingCycle": "monthly",
"purchaseFullTerm": false,
"termDuration": "P1Y",
"customTermEndDate": null,
"targetDate": "2023-08-09T00:00:00.000Z",
"addOnMigrations": [
{
"currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
"quantity": 17,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1M",
"customTermEndDate": null
},
{
"currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
"quantity": 23,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1Y",
"customTermEndDate": null
}
]
}