Obter o estado de registo da subscrição
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: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-CorrelationId: ec8f62e5-1d92-47e9-8d5d-1924af105123
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: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-RequestId: ec8f62e5-1d92-47e9-8d5d-1924af105123
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344
{
"subscriptionId":"<subscription-id>",
"status":"NotRegistered",
"attributes":{
"objectType":"SubscriptionRegistrationStatus"
}
}
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários