Verificare l'idoneità di un cliente per l'aggiornamento a un piano di Azure

Articolo
03/08/2025

È possibile usare la risorsaProductUpgradeRequest per verificare se un cliente è idoneo per l'aggiornamento a un piano di Azure da una sottoscrizione di Microsoft Azure (MS-AZR-0145P). Questo metodo restituisce un ProductUpgradesEligibility risorsa con idoneità per l'aggiornamento del prodotto del cliente.

Prerequisiti

Credenziali come descritto nell' autenticazione di Partner Center. 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.

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 la raccolta IAggregatePartner.ProductUpgrades.
Chiamare il metodo CheckEligibility e passare l'oggetto ProductUpgradesRequest, che restituirà un oggetto ProductUpgradesEligibility.

// IAggregatePartner partnerOperations;

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

string selectedProductFamily = "azure";

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

ProductUpgradesEligibility productUpgradeEligibility = partnerOperations.ProductUpgrades.CheckEligibility(productUpgradeRequest);

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

Richiesta REST

Sintassi della richiesta

Metodo	URI della richiesta
POST	{baseURL}/v1/productUpgrades/idoneità HTTP/1.1

Intestazioni della richiesta

Per ulteriori informazioni, vedere intestazioni REST del Centro partner.

Corpo della richiesta

Il corpo della richiesta deve contenere una risorsa ProductUpgradeRequest.

Esempio di richiesta

POST https://api.partnercenter.microsoft.com/v1/productupgrades/eligibility 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"
}

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 del messaggio.

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

{
    "customerId": "c1958bc7-3284-4952-a257-de594ee64743",
    "isEligible": true,
    "productFamily": "azure"
}

Condividi tramite