Создание миграции на новую коммерческую модель

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

Создание миграции подписки на новый коммерческий интерфейс

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

• Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает проверку подлинности с помощью автономных учетных данных приложения и приложения и пользователя.

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

• Идентификатор текущей подписки

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

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

Запрос REST

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

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

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

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

Имя.	Тип	Обязательное поле	Description
customer-tenant-id	строка	Да	Строка в формате GUID, определяющая клиент.

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

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

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

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

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

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

Обратите внимание, что вложенные надстройки (подписки надстроек с подписками надстроек) должны быть записаны в тексте запроса в виде неструктурированного списка в addOnMigrations и не вложены в другие подписки надстроек в запросе; См. последний пример запроса о том, как надстройки могут быть записаны в тексте запроса.

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

{ 
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "termDuration": "P1M", 
    "billingCycle": "Monthly", 
} 

{
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "purchaseFullTerm": true 
}

{
    "currentSubscriptionId": "66E738D6-E0BC-4FFB-8818-BDE99BC7008B",
    "quantity": 1,
    "billingCycle": "Annual",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "359011DC-B5B0-4660-850B-A8FA9B2E3309",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M"
        },
        {
            "currentSubscriptionId": "159D9F87-CE39-4EBD-B9C2-ECF0892A85A1",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y"
        }
    ]
}

Ответ REST

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

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

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

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

{
    "addOnMigrations": [
        {
            "currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
            "customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "catalogItemId": "CFQ7TTC0LH0T:0001:CFQ7TTC0K4KQ",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "80906BD9-E45C-4D1B-92A8-EA3F3FB6E105",
            "customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "catalogItemId": "CFQ7TTC0LH0R:0001:CFQ7TTC0K0SK",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "72E424F4-10FF-4C76-B101-C274F73BA498",
            "customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "catalogItemId": "CFQ7TTC0LHXJ:0001:CFQ7TTC0KHTR",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        }
    ],
    "id": "7123c075-fc05-42d6-a21e-1d2036fa490b",
    "startedTime": "2022-02-23T13:00:48.4489832Z",
    "currentSubscriptionId": "2E56C7F5-E120-4CA4-BFF3-7DA763B4D777",
    "status": "Processing",
    "customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}