Compartilhar via

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

Se comprometer ou abusar, os parceiros com assinaturas de cliente do Azure podem cancelar as assinaturas diretamente do portal do Partner Center ou pela API, desligando 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 delas.

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

Não há suporte para o cancelamento do plano do Azure pela API a seguir.

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

Pré-requisitos

  • Credenciais conforme descrito em Autenticação do Partner Center Esse cenário dá 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 denota o identificador do cliente.
subscription_id String Y O valor é uma cadeia de caracteres que denota o identificador da assinatura.
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: 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/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
  "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 êxito 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álida.
BadRequest 400 800002 A ID {0} do cliente deve ter o formato GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
BadRequest 400 800002 A ID da assinatura é necessária.
BadRequest 400 800002 A ID do direito é necessária.
BadRequest 400 800002 O conteúdo da solicitação de cancelamento de direito do Azure é necessário.
Proibido 403 900159 O parceiro com ID {0} de conta e ID {1} de organização não tem relação comercial com o cliente com ID de conta {2} e ID {3}de 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 do 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/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"method": "GET",
"headers": []
 }
}

Conteúdo relacionado