Начать миграцию на новую коммерческую платформу

Область применения: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для облака Microsoft для правительства США

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

Предпосылки

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

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

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

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

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

REST-запрос

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

Метод Запрос URI
ПОМЕСТИТЬ {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce HTTP/1.1

URI-параметр

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

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

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

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

Основное содержание запроса

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

Недвижимость Тип Обязательно Описание
текущийИдентификаторПодписки струна Да Идентификатор подписки, указывающий, какая подписка требует проверки для миграции.
срок действия струна нет Продолжительность срока может быть изменена при миграции.
цикл выставления счетов струна нет Цикл выставления счетов может быть изменен при миграции.
приобретениеПолныйСрок булевая переменная (bool) нет Новый семестр можно начать в NCE после миграции.
количество инт нет Количество лицензий для подписки может быть увеличено или уменьшено при миграции.
ДатаОкончанияПользовательскогоСрока дата/время нет Можно задать дату окончания для соответствия существующей непробной подписке 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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}
  • Last updated on