Получение права Azure для подписки
Область применения: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud for US Government
Партнеры могут просматривать свои права Azure для подписки с помощью этого API, который получает право идентификатора подписки для клиента.
Необходимые компоненты
- Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает проверку подлинности с помощью автономных учетных данных приложения и приложения и пользователя.
- Customer_id.
- Subscription_id.
- Entitlement_id.
C#
Чтобы отменить подписку Azure, необходимо указать идентификатор клиента, идентификатор подписки и идентификатор права для подписки Azure, которую вы хотите отменить.
Чтобы получить клиента, обратитесь к запросу Get a customer by ID and Get customer by customer id — REST API для получения дополнительной справки.
Чтобы получить подписку, ознакомьтесь с разделом "Получить подписку по идентификатору" и "Получить подписку по идентификатору" — REST API для получения дополнительной справки.
Чтобы получить право, см. статью "Получить право Azure" для подписки — REST API.
Запрос 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": []
}
}
Следующие шаги
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по