Registrar uma assinatura
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