Obtener fechas de finalización de períodos personalizados
Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government
Los partners pueden ver las fechas de finalización de términos personalizados permitidas para las suscripciones basadas en licencias de NCE que están comprando para sus clientes. Los partners pueden ver las fechas de finalización que se alinean con el final del mes natural o ese período de cooperación con las suscripciones de cliente existentes.
Las API solo admiten el cálculo de fechas de finalización de términos personalizados para la compra de nuevas suscripciones y no para la renovación de suscripciones existentes.
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.
A CustomerTenantId. 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, busque el identificador de Microsoft en la sección Información de la cuenta de cliente. El identificador de Microsoft es el mismo que el identificador de cliente.
Solicitud REST
Sintaxis de la solicitud
| Método | URI de solicitud |
|---|---|
| GET | {baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates |
Cadenas de consulta
En esta tabla se enumeran las cadenas de consulta necesarias para filtrar y recuperar fechas de finalización de términos personalizados.
| Nombre: | Requerido: | Descripción: |
|---|---|---|
| term_duration | Sí | Representación ISO 8601 de la duración del término. Los valores admitidos actuales son P1M (1 mes), P1Y (1 año) y P3Y (3 años). |
| term_start_date | No | Fecha prevista de compra. Esto no puede estar en el pasado. |
| target_coterm_subscription_id | No | Cadena con formato GUID con la que se identifica la suscripción a coterm. |
Encabezados de solicitud
Para obtener más información, consulta Encabezados REST del Centro de partners. La respuesta de la API devuelve un máximo de 300 registros de página. Si se devuelven más de 300 registros en una consulta con entrada, se proporciona un token de continuación en el encabezado de respuesta. El token de continuación puede escribirse en el encabezado de una solicitud siguiente para devolver registros de página adicionales consultados.
Cuerpo de la solicitud
Ninguno.
Respuesta REST
Si se ejecuta correctamente, este método devuelve detalles de las suscripciones que se migraron (objeto de migración) en el cuerpo de la respuesta. Esto incluye el identificador de migración.
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 dirección URL de solicitud
baseurl/v1/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M
Ejemplos de respuesta
{
"totalCount": 2,
"items": [
{
"allowedCustomTermEndDateType": "calendarMonthAligned",
"allowedCustomTermEndDate": "2023-07-31T00:00:00"
},
{
"allowedCustomTermEndDateType": "subscriptionAligned",
"cotermSubscriptionIds": [
"5fcf618b-1daa-4604-da99-cc3e1c9ee422",
"d30a9ff9-713e-4546-c97e-f06b9dcf6ef6"
],
"allowedCustomTermEndDate": "2023-08-01T00:00:00"
}
],
"links": {
"self": {
"uri": "/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}