Partilhar via


Obter um acesso do Azure para uma subscrição

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para a Nuvem Microsoft para o Governo dos EUA

Os parceiros podem visualizar os seus direitos do Azure para uma subscrição utilizando esta API, que obtém os direitos associados ao identificador da subscrição de um cliente.

Pré-requisitos

  • Credenciais de autenticação, como descrito no Partner Center. Este cenário oferece suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
  • ID do cliente
  • ID de Subscrição.
  • 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.

Pedido REST

Sintaxe da solicitação

Método Solicitar URI
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id} 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.
identificador_de_assinatura String Y O valor é uma cadeia de caracteres que denota o identificador do cliente.
entitlement_id Corda Y O valor é uma cadeia de caracteres que indica o identificador do direito de assinatura do Azure.

Cabeçalhos de solicitação

Consulte os cabeçalhos REST do Partner Center.

Corpo do pedido

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 bem-sucedido, este método retorna um direito de uso 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.

Estado HTTP Código HTTP Código de erro Descrição
PedidoInválido 400 900118 ID de cliente inválido.
PedidoInválido 400 800002 O ID do Cliente {0} deve ter o formato GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
PedidoInválido 400 800002 É necessário um ID de subscrição.
PedidoInválido 400 800002 É necessário o ID de autorização.
PedidoInválido 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 {0} e ID da organização {1} não tem nenhuma relação comercial com o cliente com ID de conta {2} e ID da organização {3}.
PedidoInválido 400 900307 Motivo de cancelamento '{0} é inválido.
Não Encontrado 404 800111 A permissão do Azure com ID {0} não foi encontrada.

Exemplo de resposta

A resposta retorna os direitos do Azure para um cliente específico.

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/aaaabbbb-0000-cccc-1111-dddd2222eeee/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f", 
            "method": "GET", 
            "headers": [] 
        } 
    }