Registrar uma assinatura

Artigo
01/11/2024

Registre uma Assinatura existente para que ela seja habilitada para solicitar reservas do Azure.

Para comprar uma reserva do Azure, você deve ter pelo menos uma assinatura CSP Azure existente. Esse método permite que você registre sua assinatura existente do CSP Azure, habilitando-a para comprar reservas do Azure.

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.
Uma ID do cliente (customer-tenant-id). Se você não souber a ID do cliente, poderá procurá-la no Partner Center selecionando o espaço de trabalho Clientes, o cliente na lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente. A ID da Microsoft é igual à ID do cliente (customer-tenant-id).
Uma ID de assinatura.

C#

Para registrar a assinatura de um cliente, recupere uma interface para operações de assinatura chamando o método IAggregatePartner.Customers.ById com a ID do cliente para identificar o cliente. Em seguida, chame o método Subscription.ById() com o ID da assinatura para identificar a assinatura que você está registrando.

Finalmente, chame o método Registration.Register() para registrar a assinatura e recuperar um URI que pode ser usado para obter o status de registro da assinatura. Para obter mais informações, consulte Obter status de registro de assinatura.

// IAggregatePartner partnerOperations;
// var selectedCustomerId;
// var selectedSubscriptionId;

// Retrieve the subscription registration details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).Registration.Register();

Solicitação REST

Sintaxe da solicitação

Método	URI da solicitação
POST	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrations HTTP/1.1

Parâmetros do URI

Use os seguintes parâmetros de caminho para identificar o cliente e a assinatura.

Nome	Digitar	Obrigatória	Descrição
id do cliente	string	Sim	Uma cadeia de caracteres formatada em GUID que identifica o cliente.
id da assinatura	string	Sim	Uma cadeia de caracteres formatada em GUID que identifica a assinatura. Os parceiros devem usar a ID do plano do Azure para novos casos de comércio.

Cabeçalhos da solicitação

Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Corpo da solicitação

Nenhum.

Exemplo de solicitação

POST https://api.partnercenter.microsoft.com/v1/customers/<customer-id>/subscriptions/<subscription-id>/registrations HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive

Resposta REST

Se bem-sucedida, a resposta conterá um cabeçalho Location com um URI que pode ser usado para recuperar o status de registro da assinatura. Salve esse URI para uso com outras APIs REST relacionadas. Para obter um exemplo de como recuperar o status, consulte Obter status de registro de assinatura.

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 informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira Códigos de Erro.

Exemplo de resposta

HTTP/1.1 202 Accepted
Content-Length: 0
Location: /customers/<customer-id>/subscriptions/<subscription-id>/registrationstatus
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525

Compartilhar via