Compartilhar via

Obter um direito do Azure para uma assinatura

  • Artigo

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

Os parceiros podem exibir seu direito do Azure para uma assinatura usando essa API, que obtém o direito do identificador de assinatura para um cliente.

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ê precisará identificar sua ID de cliente, ID de assinatura e ID de direito para a assinatura do Azure que deseja cancelar.

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} 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 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

Nenhum corpo de solicitação é necessário.

Exemplo de solicitação

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}

HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

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 retorna o direito do Azure para um determinado cliente.

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": “inactive", 
    "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