Partilhar via

Cancelar uma subscrição do Azure

  • Artigo

Aplica-se a: Centro de Parceiros | Centro de Parceiros operado pela 21Vianet | Centro de Parceiros para a Nuvem Microsoft para o Governo dos EUA

Em caso de comprometimento ou abuso, os parceiros com subscrições de clientes do Azure podem cancelar as subscrições diretamente no portal Partner Center ou per via da API, encerrando atividades suspeitas detetadas nas respetivas subscrições do Plano 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ção 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 independentes de Aplicativo e de Aplicativo+Usuário.

  • ID de Cliente.

  • ID_de_Subscrição.

  • 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 Cadeia Y O valor é uma cadeia de caracteres que denota o identificador do cliente.
ID de subscrição Cadeia Y O valor é uma cadeia de caracteres que indica o identificador da assinatura.
identificador_de_direito Cadeia Y O valor é uma cadeia de caracteres que indica o identificador do direito de assinatura do Azure.

Cabeçalhos do pedido

Consulte os 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
Pedido Inválido 400 900118 ID de cliente inválido.
Pedido Inválido 400 800002 A ID {0} do Cliente deve ter o formato GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
Pedido Inválido 400 800002 É necessário um ID de subscrição.
Pedido Inválido 400 800002 É necessário o ID de licença.
Pedido Inválido 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.
Pedido Inválido 400 900307 Motivo de cancelamento '{0} é inválido.
Não Encontrado 404 800111 O direito de utilização do Azure com ID {0} não foi encontrado.

Exemplo de resposta

A resposta do cancelamento de uma assinatura inclui o estado da atribuição. 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