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

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

  • Статья

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

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

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

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

C#

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

Запрос REST

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

Method 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: aaaa0000-bb11-2222-33cc-444444dddddd

Ответ 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: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT

{ 
    "id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f", 
    "friendlyName": " Cancel_Azure_Subscription", 
    "status": “inactive", 
    "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e", 
    "links": { 
        "self": { 
            "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f", 
            "method": "GET", 
            "headers": [] 
        } 
    }

Связанный контент