Partilhar via

Cancelar uma subscrição do Azure

  • Artigo

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

Em caso de compromisso ou abuso, os parceiros com subscrições de clientes do Azure podem cancelar as subscrições diretamente a partir do portal do Partner Center ou através da API, encerrando atividades suspeitas detetadas nas respetivas subscrições do 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 delas.

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

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

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

Pré-requisitos

  • Credenciais conforme descrito na 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.

Pedido REST

Sintaxe da solicitação

Método Solicitar URI
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel HTTP/1.1

Parâmetro URI

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

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

Cabeçalhos do pedido

Consulte Cabeçalhos REST do Partner Center.

Corpo do pedido

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: aaaa0000-bb11-2222-33cc-444444dddddd
{
 "id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
 "friendlyName": "Cancel_Azure_Subscription ",
 "status": "active",
 "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": []
   }
  }
}

Resposta do REST

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

Códigos de sucesso e 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, consulte 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 {0} do Cliente deve ter o formato GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
BadRequest 400 800002 É necessário um ID de subscrição.
BadRequest 400 800002 É necessário apresentar um documento de identificação do 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 {0} de conta e ID {1} de organização não tem nenhuma relação comercial com o cliente com ID {2} de conta e ID {3}de organização.
BadRequest 400 900307 Motivo de 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: 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": "active",
"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": []
 }
}

Conteúdos relacionados