Настройте пользовательские даты окончания срока

Статья
03/07/2025

применимо к: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud для государственных организаций США

Партнеры могут просматривать разрешенные пользовательские даты окончания срока для лицензий NCE, которые они покупают для своих клиентов. Партнеры могут просматривать даты окончания, которые совпадают с концом календарного месяца или синхронизируются с существующими подписками клиентов.

API поддерживают только вычисление пользовательских дат окончания срока покупки новых подписок, а не для продления существующих подписок.

Необходимые условия

Учетные данные, указанные в аутентификации Центра партнеров. Этот сценарий поддерживает проверку подлинности как с помощью автономных учетных данных приложения, так и с помощью учетных данных приложения с пользователем.
Идентификатор арендатора клиента. Если вы не знаете идентификатор клиента, его можно найти в Центре партнеров, выбрав раздел Клиенты, затем клиента из списка, после чего учетную запись. На странице "Учетная запись клиента" найдите Microsoft ID в разделе сведения об учетной записи клиента. Идентификатор Майкрософт совпадает с идентификатором клиента.

запрос REST

Синтаксис запроса

Метод	URI запроса
ПОЛУЧИТЬ	{baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates

Строки запроса

В этой таблице перечислены строки запроса, необходимые для фильтрации и получения пользовательских дат окончания термина.

Имя:	Обязательно:	Описание:
срок_действия	Да	Представление продолжительности термина в формате ISO 8601. Текущие поддерживаемые значения : P1M (1 месяц), P1Y (1 год) и P3Y (3 года).
дата начала срока	Нет	Предполагаемая дата покупки. Это не может быть в прошлом.
target_coterm_subscription_id	Нет	Строка с форматом GUID, определяющая подписку для coterm.

Заголовки запросов

Дополнительные сведения см. в заголовках Центра партнеров REST. Ответ API возвращает не более 300 записей страниц. Если в входном запросе возвращаются более 300 записей, маркер продолжения предоставляется в заголовке ответа. Маркер продолжения можно ввести в заголовок следующего запроса, чтобы вернуть дополнительные записи страниц, запрашиваемые.

Текст запроса

Нет.

ответ REST

В случае успешного выполнения этот метод возвращает сведения о перенесенных подписках (объект миграции) в теле ответа. Это включает идентификатор миграции.

Коды успешных ответов и ошибок

Каждый ответ содержит код состояния HTTP, указывающий на успешность или сбой и дополнительные сведения об отладке. Используйте средство трассировки сети для чтения этого кода, типа ошибки и дополнительных параметров. Полный список см. в разделе Коды ошибок REST Центра партнеров.

Примеры URL-адресов запроса

baseurl/v1/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M

Примеры ответов

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

Поделиться через