Cancelar uma assinatura do Azure

  • Artigo

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o Microsoft Cloud for US Government

Em caso de comprometimento ou abuso, os parceiros com assinaturas de clientes do Azure podem cancelar as assinaturas diretamente do portal do Partner Center ou pela API, encerrando atividades suspeitas descobertas em suas assinaturas de plano do Azure.

Essa API cancelará uma assinatura do Azure. Se os parceiros quiserem cancelar mais de uma assinatura, eles precisarão chamar separadamente a API para cancelar cada uma.

Se os parceiros quiserem suspender seu plano do Azure, eles devem usar a API existente disponível, Atualizar uma assinatura por ID.

O cancelamento do plano do Azure não é suportado pela API a seguir.

Os parceiros devem ser Administradores Globais com funções de Agente Administrador para serem cancelados.

Pré-requisitos

  • Credenciais conforme descrito em Autenticação do Partner Center Este cenário oferece suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.

  • Customer_id.

  • Subscription_id.

  • Entitlement_id.

C#

Para cancelar uma assinatura do Azure, você precisa identificar sua ID de cliente, ID de assinatura e ID de direito para essa assinatura.

Solicitação REST

Sintaxe da solicitação

Método URI da solicitação
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel HTTP/1.1

Parâmetro do URI

Esta tabela lista os parâmetros de consulta necessários para cancelar uma assinatura do Azure.

Nome Tipo Obrigatório Descrição
customer_id String Y O valor é uma cadeia de caracteres que indica o identificador do cliente.
subscription_id String Y O valor é uma cadeia de caracteres que indica o identificador do cliente.
entitlement_id String Y O valor é uma cadeia de caracteres que denota o identificador do direito de assinatura do Azure.

Cabeçalhos da solicitação

Consulte Cabeçalhos REST do Partner Center.

Corpo da solicitação

HTTP
{ "cancellationReason": "compromise" }

Exemplo de solicitação

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

Resposta REST

Se for bem-sucedido, esse método retornará um direito do Azure para um recurso de assinatura no corpo da resposta.

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e mais informações de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e outros parâmetros. Para obter a lista completa, confira Códigos de erro REST do Partner Center.

HTTP Status Código HTTP Código de erro Descrição
BadRequest 400 900118 ID de cliente inválido.
BadRequest 400 800002 A ID do {0} cliente deve ter o formato GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
BadRequest 400 800002 A ID da assinatura é necessária.
BadRequest 400 800002 É necessário um documento de identificação de direito.
BadRequest 400 800002 O conteúdo da solicitação de cancelamento de direitos do Azure é necessário.
Proibido 403 900159 O parceiro com ID de conta e ID de organização não tem relação comercial com o cliente com ID de conta e ID {1}{2} de {0}{3}organização.
BadRequest 400 900307 O motivo do cancelamento '{0} é inválido.
NotFound 404 800111 O direito do Azure com ID {0} não foi encontrado.

Exemplo de resposta

A resposta para cancelar uma assinatura inclui o status de direito. Espere cerca de 10 minutos para que o status seja refletido (ou seja, ativo para inativo).

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

Próximas etapas