Проверка подписки для миграции

Статья
10/14/2023

Область применения: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud for US Government

Как проверить подписку на миграцию в New Commerce Experience

Необходимые компоненты

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

Ограничение скорости

Ограничение API проверки миграции составляет 450 вызовов на комбинацию партнеров и клиентов за 5 минут. Дополнительные сведения об ограничениях скорости и регулировании доступны в руководстве по регулированию API.

Запрос REST

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

Метод	URI запроса
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/new commerce/validate HTTP/1.1

Параметр универсального кода ресурса

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

Имя.	Тип	Обязательное поле	Description
customer-tenant-id	строка	Да	Строка в формате GUID, определяющая клиент.
termDuration	строка	No	Срок действия можно изменить при миграции.
billingCycle	строка	No	Цикл выставления счетов можно изменить при миграции.
приобретениеFullTerm	bool	No	Новый термин можно запустить в NCE после миграции.
quantity	INT	No	Количество лицензий для подписки может быть увеличено или уменьшено при миграции.
customTermEndDate	datetime	No	Можно задать дату окончания для соответствия существующей подписке OnlineServicesNCE или календарного месяца. Дополнительные сведения о выравнивании дат окончания подписки см. здесь: выравнивание дат окончания подписки в Центре партнеров

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

Дополнительные сведения см. в статье о заголовках REST Центра партнеров.

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

В этой таблице описываются свойства подписки в тексте запроса.

Свойство	Тип	Обязательное поле	Description
currentSubscriptionId	строка	Да	Идентификатор подписки, указывающий, какая подписка требует проверки для миграции.

Пример запроса

"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"

Ответ REST

В случае успешного выполнения этот метод возвращает логическое значение isEligible в тексте ответа, указывающее, имеет ли текущая подписка право на миграцию в новую коммерческую среду. Обратите внимание, что API проверки миграции не предоставляет сведения о правах подписки на повышение уровня в Новой коммерции.

Коды успешного выполнения и ошибок в ответе

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

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

1. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": false,
        "errors": [
            {
                "code": 5,
                "description": "Subscription cannot be migrated to New Commerce because the equivalent offer is not yet available in New Commerce",
            }
        ]
    }

2. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": true,
        "catalogItemId": "CFQ7TTC0LF8S:0002:CFQ7TTC0KSVV"
    }