Condividi tramite


Ottenere lo stato di aggiornamento del prodotto per un cliente

È possibile usare la risorsa ProductUpgradeRequest per ottenere lo stato di un aggiornamento a una nuova famiglia di prodotti. Questa risorsa si applica quando si aggiorna un cliente da una sottoscrizione di Microsoft Azure (MS-AZR-0145P) a un piano di Azure. Una richiesta con esito positivo restituisce la risorsa ProductUpgradesEligibility.

Prerequisiti

  • Credenziali descritte in 'autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app+utente. Seguire il modello di app sicura quando si usa l'autenticazione app+utente con le API del Centro per i partner.

  • ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo in Centro per i partner selezionando l'area di lavoro clienti, quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente cercare il ID Microsoft nella sezione informazioni sull'account cliente. L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).

  • Famiglia di prodotti.

  • "L'ID di aggiornamento di una richiesta di aggiornamento."

C#

Per verificare se un cliente è idoneo per l'aggiornamento al piano di Azure:

  1. Creare un oggetto ProductUpgradesRequest e specificare l'identificatore del cliente e "Azure" come famiglia di prodotti.

  2. Utilizzare la collezione IAggregatePartner.ProductUpgrades.

  3. Chiamare il metodo ById e passare l'id di aggiornamento .

  4. Chiamare il metodo CheckStatus e passare l'oggetto ProductUpgradesRequest, che restituirà un oggetto 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)
{
    ....
}

Richiesta REST

Sintassi della richiesta

Metodo URI della richiesta
POST {baseURL}/v1/productUpgrades/{upgrade-id}/status HTTP/1.1

Parametro URI

Usare il parametro di query seguente per specificare il cliente per cui viene visualizzato lo stato di aggiornamento del prodotto.

Nome Digitare Obbligatorio Descrizione
identificativo-aggiornamento GUID (Identificatore Unico Globale) Il valore è un identificatore di aggiornamento in formato GUID. È possibile usare questo identificatore per specificare un aggiornamento da monitorare.

Intestazioni della richiesta

Per ulteriori informazioni, vedere intestazioni REST del Partner Center.

Corpo della richiesta

Il corpo della richiesta deve contenere una risorsa ProductUpgradeRequest.

Esempio di richiesta

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

Importante

A partire da giugno 2023, la versione più recente di .NET SDK del Centro per i partner 3.4.0 è ora archiviata. È possibile scaricare la versione dell'SDK da GitHub, insieme a un file leggimi che contiene informazioni utili.

I partner sono invitati a continuare a usare le API REST del Centro per i partner .

Risposta REST

In caso di esito positivo, questo metodo restituisce nel corpo una risorsa ProductUpgradesEligibility.

Codici di errore e esito positivo della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere il codice, il tipo di errore e i parametri aggiuntivi. Per l'elenco completo, vedere codici di errore REST del Centro per i partner.

Esempio di risposta

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"
        }
    ]
}