Registar uma subscrição

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 existente do CSP Azure. 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 na autenticação do Partner Center. Este cenário oferece suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
Um ID de cliente (customer-tenant-id). Se não souber o ID do cliente, pode procurá-lo no Partner Center selecionando a área de trabalho Clientes e, em seguida, 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 é a mesma que a ID do cliente (customer-tenant-id).
Um ID de subscrição.

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 a 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();

Pedido REST

Sintaxe da solicitação

Método	URI do pedido
POST	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrations HTTP/1.1

Parâmetros de URI

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

Nome	Type	Obrigatório	Description
ID do cliente	string	Sim	Uma cadeia de caracteres formatada em GUID que identifica o cliente.
ID da subscrição	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 do pedido

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

Corpo do pedido

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 do REST

Se bem-sucedida, a resposta contém um cabeçalho Location com um URI que pode ser usado para recuperar o status de registro da assinatura. Salve este 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 sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações adicionais de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e parâmetros adicionais. Para obter a lista completa, consulte 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

Partilhar via