Obter o estado de aprovisionamento da subscrição

Artigo
11/05/2024

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center for Microsoft Cloud for US Government

Como obter o status de provisionamento de assinatura para uma assinatura de cliente.

Pré-requisitos

Credenciais conforme descrito na autenticação do Partner Center. Este cenário suporta autenticação apenas com credenciais App+User.
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 identificador de assinatura.
São necessárias permissões de administrador delegadas na subscrição para executar esta operação.

Funções granulares de privilégios de administrador delegado (GDAP)

Você precisa de pelo menos uma das seguintes funções GDAP:

Leitor de Diretórios
Leitor Global

C#

Para obter o status de provisionamento 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 Subscriptions.ById com a ID da assinatura. Em seguida, use a propriedade ProvisioningStatus para obter uma interface para as operações de status de provisionamento da assinatura atual e chame o método Get ou GetAsync para recuperar o objeto SubscriptionProvisioningStatus.

// IAggregatePartner partnerOperations.
// string customerId;
// string subscriptionId;

// Retrieve a subscription's provisioning status.
var provisioningStatus = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionID).ProvisioningStatus.Get();

Pedido REST

Sintaxe da solicitação

Método	URI do pedido
GET	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/provisioningstatus 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.

Cabeçalhos do pedido

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

Corpo do pedido

Nenhum.

Exemplo de solicitação

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Resposta do REST

Se bem-sucedida, o corpo da resposta contém um recurso SubscriptionProvisioningStatus .

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e outras informações de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e outros parâmetros. Para obter a lista completa, consulte Códigos de erro REST do Partner Center.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344
Date: Thu, 20 Apr 2017 19:23:39 GMT

{
    "skuId": "6FD2C87F-B296-42F0-B197-1E91E994B900",
    "status": "success",
    "quantity": 5,
    "endDate": "2018-05-10T00:00:00Z",
    "attributes": {
        "objectType": "SubscriptionProvisioningStatus"
    }
}

Observações

O campo de status em SubscriptionProvisioningStatus é definido como "pendente" durante uma atribuição de alteração de licença.
O campo de status é atualizado a cada 15 minutos.

Partilhar via