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 seus direitos 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 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ê 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 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

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: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd

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