Отмените подписку Azure

  • Статья

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

Если компрометация или злоупотребление, партнеры с клиентскими подписками Azure могут отменить подписки непосредственно с портала Центра партнеров или API, завершив работу подозрительных действий, обнаруженных в подписках плана Azure.

Этот API отменит подписку Azure. Если партнеры хотят отменить несколько подписок, им необходимо отдельно вызвать API, чтобы отменить каждую из них.

Если партнеры хотят приостановить свой план Azure, они должны использовать существующий API, обновите подписку по идентификатору.

Отмена плана Azure не поддерживается следующим API.

Для отмены партнеров должны быть глобальные Администратор istrator с ролями агента Администратор.

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

  • Учетные данные, как описано в проверке подлинности Центра партнеров, поддерживают проверку подлинности с помощью автономных учетных данных app и App+User.

  • Customer_id.

  • Subscription_id.

  • Entitlement_id.

C#

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

Запрос REST

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

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

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

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

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

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

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

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

HTTP
{ "cancellationReason": "compromise" }

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

POST
[https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel](https://api.partnercenter.microsoft.com/v1/customers/%7bcustomer_id%7d/subscriptions/%7bsubscription_id%7d/azureEntitlements/%7bentitlement_id%7d/cancel)
HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
{
 "id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
 "friendlyName": "Cancel_Azure_Subscription ",
 "status": "active",
 "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": []
   }
  }
}

Ответ 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} не найдено.

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

Ответ на отмену подписки включает состояние прав. Ожидается около 10 минут для отражения состояния (то есть активного для неактивного).

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": "active",
"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": []
 }
}

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