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.
Para obter um cliente, consulte Obter cliente por ID e Obter cliente pelo ID do cliente - API REST para mais ajuda.
Para obter uma subscrição, consulte Obter uma subscrição por ID e Obter subscrição por ID - API REST para mais ajuda.
Para obter uma permissão, consulte Obtenha uma permissão do Azure para uma assinatura - API REST.
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": []
}
}