Compartilhar via


Obter o status de registro de assinatura

Como obter o registro de assinatura status para uma assinatura de cliente que foi habilitada para a compra de Instâncias de VM Reservadas do Azure.

Para comprar uma Instância de VM Reservada do Azure usando a API do Partner Center, você deve ter pelo menos uma assinatura do CSP Azure existente. O método Registrar uma assinatura permite que você registre sua assinatura do CSP Azure existente, habilitando-a para a compra de Instâncias de VM Reservadas do Azure. Esse método permite que você recupere o status desse registro.

Pré-requisitos

  • Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá 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á pesquisá-la no Partner Center selecionando o workspace 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 obter o registro status de uma assinatura, comece usando o método IAggregatePartner.Customers.ById com a ID do cliente para identificar o cliente. Em seguida, obtenha uma interface para operações de assinatura chamando o método Subscription.ById() com a ID da assinatura para identificar a assinatura. Em seguida, use a propriedade RegistrationStatus para obter uma interface para o registro da assinatura atual status operações e chame o método Get ou GetAsync para recuperar o objeto SubscriptionRegistrationStatus.

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

// Retrieve a subscription's registration status details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).RegistrationStatus.Get();

Solicitação REST

Sintaxe da solicitação

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

Parâmetros do URI

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

Nome Type Obrigatório Descrição
id do cliente string Sim Uma cadeia de caracteres formatada por GUID que identifica o cliente.
id da assinatura string Sim Uma cadeia de caracteres formatada por GUID que identifica a assinatura.

Cabeçalhos de solicitação

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

Corpo da solicitação

Nenhum.

Exemplo de solicitação

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-id>/subscriptions/<subscription-id>/registrationstatus 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 tiver êxito, o corpo da resposta conterá um recurso SubscriptionRegistrationStatus .

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 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344

{
    "subscriptionId":"<subscription-id>",
    "status":"NotRegistered",
    "attributes":{
        "objectType":"SubscriptionRegistrationStatus"
    }
}