Obter o status de atualização do produto para um cliente

Você pode usar o recursoProductUpgradeRequest para obter o status de uma atualização para uma nova família de produtos. Este recurso aplica-se quando está a atualizar um cliente de uma subscrição do Microsoft Azure (MS-AZR-0145P) para um plano do Azure. Uma solicitação bem-sucedida retorna o recurso ProductUpgradesEligibility.

Pré-requisitos

• Credenciais conforme descrito na autenticação do Partner Center . Este cenário oferece suporte à autenticação com credenciais App+User. Siga o modelo de aplicativo seguro ao usar a autenticação de App+Utilizador com APIs do Partner Center.

• Um ID de cliente (customer-tenant-id). Se não souber o ID do cliente, pode procurá-lo no Partner Center selecionando o espaço de trabalho Clientes, depois o cliente da lista de clientes, e em seguida Conta. Na página de Conta do cliente, procure o 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).

• A família de produtos.

• A ID de atualização de uma solicitação de atualização.

C#

Para verificar se um cliente está qualificado para atualizar para o plano do Azure:

1. Crie um objeto ProductUpgradesRequest e especifique o identificador do cliente e "Azure" como a família do produto.

2. Utilize a coleção IAggregatePartner.ProductUpgrades.

3. Chame o ById método e passe o upgrade-id .

4. Chame o método CheckStatus e passe o objeto ProductUpgradesRequest, que retornará um objeto ProductUpgradeStatus.

// IAggregatePartner partnerOperations;

string selectedCustomerId = "58e2af4f-0ad3-4688-8744-be2357cd939a";

string selectedProductFamily = "azure";

var productUpgradeRequest = new ProductUpgradesRequest
{
    CustomerId = selectedCustomerId,
    ProductFamily = selectedProductFamily
};

ProductUpgradesStatus productUpgradeStatus = partnerOperations.ProductUpgrades.ById(selectedUpgradeId).CheckStatus(productUpgradeRequest);

if (productUpgradeEligibility.IsEligibile)
{
    ....
}

Pedido REST

Sintaxe da solicitação

Parâmetro URI

Use o parâmetro de consulta a seguir para especificar o cliente para o qual você está recebendo um status de atualização de produto.

Cabeçalhos de solicitação

Para mais informações, consulte os cabeçalhos REST do Partner Center .

Corpo do pedido

O corpo da solicitação deve conter um recurso ProductUpgradeRequest.

Exemplo de solicitação

POST https://api.partnercenter.microsoft.com/v1/productupgrades/42d075a4-bfe7-43e7-af6d-7c68a57edcb4/status  HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c245d5f2-1de3-4ae0-9e42-95e38e3cb8ff
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 340
Expect: 100-continue
Connection: Keep-Alive
{
 {
    "customerId": "4c721420-72ad-4708-a0a7-371a2f7b0969",
    "productFamily": "azure"
  }
  "Attributes": {
  "ObjectType": "ProductUpgradeRequest"
  }
}

Resposta REST

Se bem-sucedido, este método retorna o recurso ProductUpgradesEligibility no corpo.

Códigos de sucesso e erro de resposta

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

Exemplo de resposta

HTTP/1.1 200 Ok
Content-Length: 150
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 04 Oct 2019 20:35:35 GMT

{
    "id": "42d075a4-bfe7-43e7-af6d-7c68a57edcb4",
    "status": "Completed",
    "productFamily": "Azure",
    "lineItems": [
        {
            "sourceProduct": {
                "id": "b1beb621-3cad-4d7a-b360-62db33ce028e",
                "name": "AzureSubscription"
            },
            "targetProduct": {
                "id": "d231908e-31c1-de0e-027b-bc5ce11f09d9",
                "name": "Microsoft Azure plan"
            },
            "upgradedDate": "2019-08-29T23:47:28.8524555Z",
            "status": "Completed"
        }
    ]
}