Receber status de aprovisionamento de assinatura

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

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

Pré-requisitos

• Credenciais, conforme descrito em Autenticação do Partner Center. Este cenário dá suporte somente à autenticação com credenciais de aplicativo + de 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 workspace Clientes, o cliente da 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).

• Um identificador de assinatura.

• As permissões de administrador delegado na assinatura são necessárias para executar essa 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ório
• 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, em seguida, 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();

Solicitação REST

Sintaxe da solicitação

Parâmetros do URI

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

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

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 REST

Se for bem-sucedido, o corpo da resposta conterá um recurso SubscriptionProvisioningStatus .

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 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, confira 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"
    }
}

Comentários

• 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.