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

  • Статья

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

Как запрашивать перенесенные подписки на основе идентификатора клиента, текущего идентификатора подписки или внешнего идентификатора ссылки

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

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

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

Этот API может фильтроваться на основе строк запроса, которые выбирает партнер. Выбранные строки запроса могут иметь любой из следующих трех вариантов:

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

  • CurrentSubscriptionId (устаревший идентификатор для перенесенной подписки)

  • ExternalReferenceId (идентификатор пакета, возвращаемый средством пакетной миграции, доступным для скачивания с помощью пакета SDK Центра партнеров)

Запрос REST

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

Способ URI запроса
GET {baseURL}/v1/migrations/new commerce HTTP/1.1

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

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

Имя Описание
CustomerTenantId Строка в формате GUID, определяющая клиент.
CurrentSubscriptionId Строка с форматированием GUID, определяющая перенесенную устаревшую подписку.
ExternalReferenceId Строка с форматом GUID, идентифицирующая пакет миграции.

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

Дополнительные сведения см. в статье о заголовках REST Центра партнеров. Ответ API возвращает не более 300 записей страниц. Если в входном запросе возвращаются более 300 записей, маркер продолжения предоставляется в заголовке ответа. Маркер продолжения можно ввести в заголовок следующего запроса, чтобы вернуть дополнительные записи страниц, запрашиваемые.

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

Нет.

Ответ REST

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

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

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

Примеры URL-адресов запроса

baseurl/v1/migrations/newcommerce?CustomerTenantId=83c51838-fed5-44a4-a275-afa201d53699&CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833&ExternalReferenceId=9ab61899-0b2b-4320-bd6d-8196c53607d6

baseurl/v1/migrations/newcommerce?CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833

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

[
{
"addOnMigrations": [],
"id": "8ce7115e-0324-41b1-8ca3-7c7ae3b64f75",
"startedTime": "2022-02-24T23:50:30.4384819Z",
"completedTime": "2022-02-24T23:53:14.0813711Z",
"currentSubscriptionId": "9E289691-2FF3-419D-B39B-26B3E5A817FB",
"status": "Completed",
"customerTenantId": "ce6fcc21-c276-447b-9605-874decb9024b",
"catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
"newCommerceSubscriptionId": "f2d6534b-9e30-4cf5-c7b0-5d6393dbf12d",
"newCommerceOrderId": "09714c93092a",
"subscriptionEndDate": "2023-02-14T00:00:00Z",
"quantity": 2,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"externalReferenceId": "771317a4-275d-47d9-9724-3eefa4a168ad"
}
]