Получение права Azure для подписки

  • Статья

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

Партнеры могут просматривать свои права Azure для подписки с помощью этого API, который получает право идентификатора подписки для клиента.

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

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

C#

Чтобы отменить подписку Azure, необходимо указать идентификатор клиента, идентификатор подписки и идентификатор права для подписки Azure, которую вы хотите отменить.

Запрос REST

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

Метод URI запроса
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id} HTTP/1.1

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

В этой таблице перечислены необходимые параметры запроса для отмены подписки Azure.

Имя Тип Обязательное поле Description
customer_id Строка Y Значение — это строка, которая обозначает идентификатор клиента.
subscription_id Строка Y Значение — это строка, которая обозначает идентификатор клиента.
entitlement_id Строка Y Это строка, которая обозначает идентификатор права подписки Azure.

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

См . заголовки REST Центра партнеров.

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

Текст запроса не является обязательным.

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

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}

HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd

Ответ REST

В случае успешного выполнения этот метод возвращает право Azure для ресурса подписки в тексте ответа.

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

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

Состояние HTTP КОД HTTP Код ошибки Description
BadRequest 400 900118 Недопустимый идентификатор клиента.
BadRequest 400 800002 Идентификатор {0} клиента должен иметь формат GUID (xxxx-xxxx-xxxx-xxxx).
BadRequest 400 800002 Требуется идентификатор подписки.
BadRequest 400 800002 Требуется идентификатор права.
BadRequest 400 800002 Требуется содержимое запроса на отмену прав Azure.
Запрещено 403 900159 Партнер с идентификатором учетной записи и идентификатором {0}{1} организации не имеет связи с клиентом с идентификатором учетной записи и идентификатором {2}{3}организации.
BadRequest 400 900307 Причина отмены является{0} недопустимой.
Не найдено 404 800111 Право Azure с идентификатором {0} не найдено.

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

Ответ возвращает право Azure для данного клиента.

HTTP
HTTP/1.1 200 OK
Content-Length: 1132
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 6eacec93-852d-4167-9d96-c57809bea7ed
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT

{ 
    "id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383", 
    "friendlyName": " Cancel_Azure_Subscription", 
    "status": “inactive", 
    "subscriptionId": "065eefc4-915b-453d-c558-152e39ec25b1", 
    "links": { 
        "self": { 
            "uri": "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/065eefc4-915b-453d-c558-152e39ec25b1/azureEntitlements/5b76b8c3-dd85-4096-bb2e-9804b1d7b383", 
            "method": "GET", 
            "headers": [] 
        } 
    }

Следующие шаги