Получение сведений о переходах
Применимо к:
- Центр партнеров
Соответствующие роли
- Глобальный администратор
- Агент по администрированию
Примечание.
Новые возможности коммерческой торговли для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщик облачных решений (ПОСТАВЩИКОВ УСЛУГ). Дополнительные сведения см . в обзоре новых коммерческих возможностей.
Используется для получения журнала переходов для конкретного клиента и подписки. Журнал включает все события, обработанные для перехода. Это поддерживает только переходы на основе лицензий на основе коммерческой торговли.
Необходимые компоненты
Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает проверку подлинности с помощью автономных учетных данных приложения и приложения и пользователя.
Идентификатор клиента (
customer-tenant-id
). Если вы не знаете идентификатор клиента, его можно найти в Центре партнеров, выбрав рабочую область "Клиенты" , затем клиент из списка клиентов, а затем учетная запись. На странице учетной записи клиента найдите Идентификатор Майкрософт в разделе Сведения об учетной записи клиента. Идентификатор Майкрософт совпадает с идентификатором клиента (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 |
Параметр универсального кода ресурса
Используйте следующие параметры запроса для возврата подходящих переходов.
Имя. | Type | Обязательно | Описание |
---|---|---|---|
customer-tenant-id | guid | Y | GUID, соответствующий клиенту клиента. |
subscription-id | 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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US
Ответ REST
При успешном выполнении возвращается журнал переходов для предоставленной подписки.
Коды успешного выполнения и ошибок в ответе
Каждый ответ сопровождается кодом состояния HTTP, обозначающим успешное или неудачное выполнение, и дополнительными сведениями для отладки. Используйте средство трассировки сети, чтобы просматривать этот код, тип ошибки и дополнительные параметры. См. полный список кодов ошибок.
Пример ответа
HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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"
}
}
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по