Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Se aplica a: Centro de asociados | Centro de asociados operado por 21Vianet | Centro de asociados para la Nube de Microsoft para el Gobierno de los EE. UU.
Los partners pueden ver las fechas de finalización de los plazos personalizados permitidos para las suscripciones basadas en licencias de NCE que compran para sus clientes. Los partners pueden ver las fechas de finalización que coinciden con el final del mes natural o que coinciden con las suscripciones de clientes existentes.
Las API solo admiten el cálculo de fechas de finalización de plazos personalizados para la compra de nuevas suscripciones y no para la renovación de las suscripciones existentes.
Prerrequisitos
Credenciales tal como se describe en Autenticación del Centro de asociados. Este escenario admite la autenticación con credenciales de aplicación independiente y app+usuario.
Un CustomerTenantId. Si no conoce el identificador del cliente, puede buscarlo en Partner Center 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 Id. de Microsoft en la sección Información de la cuenta de cliente. El ID de Microsoft es el mismo que el ID de cliente.
Solicitud REST
Sintaxis de la solicitud
| Método | Solicitud de URI |
|---|---|
| OBTENER | {baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates |
Cadenas de consulta
En esta tabla se enumeran las cadenas de consulta necesarias para filtrar y recuperar las fechas de finalización de los términos personalizados.
| Nombre: | Requerido: | Descripción: |
|---|---|---|
| term_duration | Sí | Una representación ISO 8601 de la duración del término. Los valores admitidos actualmente son P1M (1 mes), P1Y (1 año) y P3Y (3 años). |
| term_start_date | No | La fecha prevista de compra. Esto no puede quedar en el pasado. |
| target_coterm_subscription_id | No | Cadena con formato GUID que identifica la suscripción con la que se va a coterminar. |
Nota:
Las duraciones de términos de P1M o términos mensuales que se pasan a la API devolverán resultados co-termino que no podrán utilizarse para la alineación de términos. Las alineaciones mensuales no se pueden usar con una suscripción que finalice el 28, 29 o 30 del mes, a menos que esa fecha sea el último día del mes.
Cabeceras de solicitud
Para más información, consulte 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 entrada, se proporciona un token de continuación en el encabezado de respuesta. El token de continuación se puede introducir en el encabezado de una solicitud siguiente para devolver registros de página adicionales consultados.
Cuerpo de la solicitud
Ninguno.
Respuesta REST
Si se realiza 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 ID de migración.
Códigos de éxito y de error de la respuesta
Cada respuesta incluye un código de estado HTTP que indica el éxito o error y la información adicional de depuración. Use una herramienta de seguimiento de red para leer este código, tipo de error y parámetros adicionales. Para obtener la lista completa, consulta Códigos de error de REST del Centro de socios.
Ejemplos de 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"
}
}