Obtener fechas de finalización de períodos personalizados

Artículo
02/23/2024

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"
    }
 }

Share via