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

Статья
02/05/2024

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

Чтобы приобрести экземпляр зарезервированной виртуальной машины Azure с помощью API Центра партнеров, у вас должна быть по крайней мере одна существующая подписка Azure CSP. Метод Register a subscription (Регистрация подписки ) позволяет зарегистрировать существующую подписку Azure CSP, чтобы приобрести зарезервированные экземпляры виртуальных машин Azure. Этот метод позволяет получить состояние этой регистрации.

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

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

C#

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

// IAggregatePartner partnerOperations;
// var selectedCustomerId;
// var selectedSubscriptionId;

// Retrieve a subscription's registration status details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).RegistrationStatus.Get();

Запрос REST

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

Метод	Универсальный код ресурса (URI) запроса
GET	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus HTTP/1.1

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

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

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

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

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

Тело запроса

Нет.

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

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-id>/subscriptions/<subscription-id>/registrationstatus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive

Ответ REST

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

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

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

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

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344

{
    "subscriptionId":"<subscription-id>",
    "status":"NotRegistered",
    "attributes":{
        "objectType":"SubscriptionRegistrationStatus"
    }
}

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