Ottenere lo stato di aggiornamento del prodotto per un cliente

Articolo
10/01/2024

È 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 dell'app e dell'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 nel 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 l'ID Microsoft nella sezione Informazioni sull'account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).
Famiglia di prodotti.
ID aggiornamento di una richiesta di aggiornamento.

C#

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

Creare un oggetto ProductUpgradesRequest e specificare l'identificatore del cliente e "Azure" come famiglia di prodotti.
Utilizzare l'insieme IAggregatePartner.ProductUpgrades .
Chiamare il metodo ById e passare l'id aggiornamento.
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

Method	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	Digita	Richiesto	Descrizione
upgrade-id	GUID	Sì	Il valore è un identificatore di aggiornamento in formato GUID. È possibile usare questo identificatore per specificare un aggiornamento da tenere traccia.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

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 una risorsa ProductUpgradesEligibility nel corpo.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Risposta di esempio

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

Condividi tramite