Отмена нового расписания миграции коммерческой торговли
Область применения: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud for US Government
Соответствующие роли: агент по администрированию | агент по продажам
В этой статье описывается, как отменить новое расписание миграции коммерческой торговли.
Необходимые компоненты
Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает проверку подлинности с помощью автономных учетных данных приложения и приложения и пользователя.
Идентификатор клиента (
customer-tenant-ID). Если вы не знаете идентификатор клиента, его можно найти в Центре партнеров, выбрав рабочую область "Клиенты" , затем клиент из списка клиентов, а затем учетная запись. На странице учетной записи клиента найдите Идентификатор Майкрософт в разделе Сведения об учетной записи клиента. Идентификатор Майкрософт совпадает с идентификатором клиента (customer-tenant-ID).Идентификатор текущей подписки
Запрос REST
Синтаксис запроса
| Method | URI запроса |
|---|---|
| POST | {baseURL}/v1/customers/{customer-tenant-id}/migrations/new commerce/schedules/{scheduleID}/cancel |
Параметр универсального кода ресурса
В этой таблице перечислены необходимые параметры запроса для создания новой коммерческой миграции.
| Имя | Тип | Обязательное поле | Description |
|---|---|---|---|
| customer-tenant-ID | строка | Да | Строка в формате GUID, определяющая клиент. |
| scheduleID | строка | Да | Строка с форматом GUID, определяющая расписание |
Заголовки запросов
Дополнительные сведения см. в статье о заголовках REST Центра партнеров.
Текст ответа
В этой таблице описываются свойства подписки в ответе.
| Свойство | Тип | Обязательное поле | Description |
|---|---|---|---|
| Идентификатор | Строка | Нет | Строка с форматом GUID, определяющая расписание |
| currentSubscriptionID | строка | Нет | Идентификатор подписки, указывающий, какая подписка требует проверки для миграции. |
| termDuration | строка | Нет | Срок действия, указанный для изменения при миграции. |
| billingCycle | строка | Нет | Цикл выставления счетов, указанный при миграции. |
| приобретениеFullTerm | bool | No | Новый термин начался в NCE после миграции. |
| quantity | INT | No | Количество лицензий увеличилось или сократилось при миграции. |
| customTermEndDate | datetime | No | Можно задать дату окончания для соответствия существующей подписке OnlineServicesNCE или календарного месяца. Дополнительные сведения о выравнивании дат окончания подписки см. здесь: выравнивание дат окончания подписки в Центре партнеров |
| targetDate | datetime | No | Целевая дата, когда необходимо запланировать миграцию. |
| миграцияOnRenewal | bool | No | Указывает, можно ли перенести подписку при продлении. |
| статус | строка | Нет | Состояние миграции расписания |
| createdTime | datetime | No | При создании расписания |
| lastModifiedTime | datetime | No | После последнего изменения расписания |
Ответ REST
В случае успешного выполнения этот метод возвращает сведения о переносе подписок (объект миграции) в тексте ответа.
Коды успешного выполнения и ошибок в ответе
Каждый ответ сопровождается кодом состояния HTTP, обозначающим успешное или неудачное выполнение, и дополнительными сведениями для отладки. Используйте средство трассировки сети для чтения этого кода, типа ошибки и других параметров. Полный список ответов есть в статье Коды ошибок REST в Центре партнеров.
Примеры ответов
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Cancelled",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00",
"createdTime": "2022-10-18T21:20:50.9668605+00:00",
"lastModifiedTime": "2022-10-18T21:29:32.8992819+00:00"
}