Получение сведений о состоянии подготовки подписки

Статья
08/12/2023

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

Получение состояния подготовки подписки для подписки клиента.

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

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

Роли GDAP

Вам потребуется по крайней мере одна из следующих ролей GDAP:

Читатель каталога
Глобальный читатель

C#

Чтобы получить состояние подготовки подписки, начните с метода IAggregatePartner.Customers.ById с идентификатором клиента для идентификации клиента. Затем получите интерфейс для операций подписки, вызвав метод Subscriptions.ById с идентификатором подписки. Затем используйте свойство ProvisioningStatus для получения интерфейса для операций состояния подготовки текущей подписки, а затем вызовите метод Get или GetAsync, чтобы получить объект SubscriptionProvisioningStatus.

// IAggregatePartner partnerOperations.
// string customerId;
// string subscriptionId;

// Retrieve a subscription's provisioning status.
var provisioningStatus = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionID).ProvisioningStatus.Get();

Запрос REST

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

Метод	URI запроса
GET	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/provisioningstatus HTTP/1.1

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

Используйте следующие параметры пути для идентификации клиента и подписки.

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

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

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

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

Нет.

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

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/34828C05-C16C-4D6F-9CFC-4D2650EF19A1/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Ответ REST

В случае успешного выполнения текст ответа содержит ресурс SubscriptionProvisioningStatus .

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

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

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

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344
Date: Thu, 20 Apr 2017 19:23:39 GMT

{
    "skuId": "6FD2C87F-B296-42F0-B197-1E91E994B900",
    "status": "success",
    "quantity": 5,
    "endDate": "2018-05-10T00:00:00Z",
    "attributes": {
        "objectType": "SubscriptionProvisioningStatus"
    }
}

Замечания

Во время назначения изменения лицензии поле состояния в SubscriptionProvisioningStatus имеет значение "ожидание".
Поле состояния обновляется каждые 15 минут.

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