Obter o estado de registo da subscrição

Artigo
02/05/2024

Como obter o estado de registo da subscrição de uma subscrição de cliente que tenha sido ativada para comprar Instâncias de VM Reservadas do Azure.

Para comprar uma Instância de VM Reservada do Azure com a API do Centro de Parceiros, tem de ter, pelo menos, uma subscrição do Azure CSP existente. O método Registar uma subscrição permite-lhe registar a sua subscrição do Azure do CSP existente, permitindo-lhe comprar Instâncias de VM Reservadas do Azure. Este método permite-lhe obter o estado desse registo.

Pré-requisitos

Credenciais conforme descrito na autenticação do Centro de Parceiros. Este cenário suporta a autenticação com credenciais de Aplicação e Aplicação+Utilizador autónomas.
Um ID de cliente (customer-tenant-id). Se não souber o ID do cliente, pode procurá-lo no Centro de Parceiros ao selecionar 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 o ID Microsoft na secção Informações da Conta de Cliente . O ID da Microsoft é o mesmo que o ID do cliente (customer-tenant-id).
Um ID de subscrição.

C#

Para obter o estado de registo de uma subscrição, comece por utilizar o método IAggregatePartner.Customers.ById com o ID do cliente para identificar o cliente. Em seguida, obtenha uma interface para operações de subscrição ao chamar o método Subscription.ById() com o ID da subscrição para identificar a subscrição. Em seguida, utilize a propriedade RegistrationStatus para obter uma interface para as operações de estado de registo da subscrição atual e chame o método Get ou GetAsync para obter 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();

Pedido REST

Sintaxe do pedido

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

Parâmetros do URI

Utilize os seguintes parâmetros de caminho para identificar o cliente e a subscrição.

Nome	Tipo	Necessário	Descrição
customer-id	string	Yes	Uma cadeia formatada guid que identifica o cliente.
subscription-id	string	Yes	Uma cadeia formatada guid que identifica a subscrição.

Cabeçalhos do pedido

Para obter mais informações, veja Cabeçalhos REST do Centro de Parceiros.

Corpo do pedido

Nenhum.

Exemplo de pedido

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

Se for bem-sucedido, o corpo da resposta contém um recurso SubscriptionRegistrationStatus .

Códigos de erro e êxito da resposta

Cada resposta inclui um código de estado HTTP que indica êxito ou falha e informações adicionais de depuração. Utilize uma ferramenta de rastreio de rede para ler este código, tipo de erro e parâmetros adicionais. Para obter a lista completa, veja 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"
    }
}

Partilhar via