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 espaço de trabalho 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).

• Um identificador de assinatura.

• Permissões de administrador delegado na assinatura são necessárias para executar essa operação.

Funções GDAP

Você precisará 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 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

Método	URI da solicitação
GET	{baseURL} /v1/clientes / {id do cliente} /subscriptions/ {id da assinatura} / provisioningstatus HTTP/1.1

Parâmetros do URI

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

Nome	Type	Obrigatório	Descrição
id do cliente	string	Sim	Uma cadeia de caracteres formatada em GUID que identifica o cliente.
id da assinatura	string	Sim	Uma cadeia de caracteres formatada em 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

None.

Exemplo de solicitação

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/34828C05-C16C-4D6F-9CFC-4D2650EF19A1/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Resposta REST

Se 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 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 REST do Partner Center.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
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

• Durante uma atribuição de alteração de licença, o campo de status em SubscriptionProvisioningStatus é definido como "pendente".

• O campo de status é atualizado a cada 15 minutos.