Планирование новой коммерческой миграции

  • Статья

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

Соответствующие роли: глобальный администратор | Агент администрирования | Агент продаж

В этой статье описывается планирование нового коммерческого интерфейса.

Предварительные требования

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

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

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

Запрос REST

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

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

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

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

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

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

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

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

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

Свойство Тип Обязательно для заполнения Описание
currentSubscriptionId строка Да Идентификатор подписки, указывающий, какая подписка требует проверки для миграции.
termDuration строка Нет Срок действия можно указать для изменения при миграции.
billingCycle строка Нет При миграции можно указать цикл выставления счетов.
приобретениеFullTerm bool Нет Новый термин можно запустить в NCE после миграции.
количество int Нет Количество лицензий для подписки может быть увеличено или уменьшено при миграции.
customTermEndDate datetime Нет Дату окончания можно задать для выравнивания существующей подписки OnlineServicesNCE или календарного месяца. Дополнительные сведения о выравнивании дат окончания подписки см. здесь: выравнивание дат окончания подписки в Центре партнеров
targetDate datetime Обязательный (если миграцияOnRenewal имеет значение NULL/false) Целевая дата, когда необходимо запланировать миграцию. Если targetDate задан для указанной даты, миграцияOnRenewal может иметь значение NULL или false.
миграцияOnRenewal bool Обязательный (если целевойDate имеет значение NULL) Если флаг имеет значение true для миграцииOnRenewal, для планирования миграции не требуется указывать целевой идентификатор.
addOnMigrationSchedules bool Нет Содержит список подписок AddOn, которые будут включены в запланированную миграцию.

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

{
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

Ответ REST

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

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

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

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

{
    "id": "f016c025-a873-47af-8b52-2516fbef4c65",
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

См. также