Получение сведений о переходах

Статья
03/08/2025

Применимо к

Центр партнеров

Соответствующие роли

Агент по администрированию

Примечание.

Новые коммерческие возможности для услуг на основе лицензий включают множество нововведений и доступны для всех поставщиков облачных решений (CSP). Для получения дополнительной информации см. обзор новых коммерческих возможностей.

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

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

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

Запрос REST

[GET] customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions

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

Способ	URI запроса
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1

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

Используйте следующие параметры запроса для возврата подходящих переходов.

Имя.	Тип	Обязательно	Описание
идентификатор клиента-арендатора	guid	Y	GUID, соответствующий арендатору клиента.
идентификатор-подписки	guid	Y	GUID, соответствующий начальной подписке.
идентификатор операции	guid	N	GUID для уникальной идентификации перехода и отслеживания его статуса.

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

Для получения дополнительной информации см. заголовки REST Центра партнеров.

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

нет

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

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

Ответ REST

При успешном выполнении возвращается журнал переходов для предоставленной подписки.

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

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

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

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "transition": [
        {
        "operationId": "1caf8ec7-62cc-4ab5-b35d-572d2a62974c", 
        "FromCatalogItemId": "CFQ7TTC0LDPB:0001:CFQ7TTC0LGNT",
        "ToCatalogItemId": "CFQ7TTC0LF8S:0001:CFQ7TTC0K9G9",
        "quantity": 1,
        "transitionType": "transition_with_license_transfer",
        "Events": [
           {
               "name": "Conversion",
               "status": "Started ",
               "timestamp": "2021-01-08T18:01:14.7488618Z",
               "attributes":
                     {
                          "objectType": "TransitionEvent"
                     }
           }, 
           {
               "name": "Conversion",
               "status": "Completed",
               "timestamp": "2021-01-08T18:37:41.591855Z",
               "attributes":
                     {
                          "objectType": "TransitionEvent"
                     }
            }
        ],
        "attributes":
               {
                     "objectType": "Transition"
               }
        }
    ],
    "attributes":
        {
               "objectType": "Collection"
        }
}

Поделиться через