Creare un'entità di aggiornamento del prodotto per un cliente

È possibile creare un'entità di aggiornamento per aggiornare un cliente a una determinata famiglia di prodotti, ad esempio piano Azure, usando la risorsa ProductUpgradeRequest.

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 l'ID Microsoft nella sezione Informazioni sull'Account Cliente. L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).

• Famiglia di prodotti a cui si vuole aggiornare il cliente.

C#

Per aggiornare un cliente al piano di Azure:

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

2. Utilizzare l'insieme IAggregatePartner.ProductUpgrades.

3. Chiamare il metodo Create e passare l'oggetto ProductUpgradesRequest, che restituirà un'intestazione percorso stringa.

4. Estrarre il id di aggiornamento dalla stringa di intestazione del percorso che può essere usata per eseguire una query sullo stato dell'aggiornamento.

// IAggregatePartner partnerOperations;

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

string selectedProductFamily = "Azure";

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

var productUpgradeLocationHeader = partnerOperations.ProductUpgrades.Create(productUpgradeRequest);

var upgradeId = Regex.Split(productUpgradeLocationHeader, "/")[1];

Richiesta REST

Sintassi della richiesta

Metodo	URI della richiesta
INSERISCI	{baseURL}/v1/productupgrades HTTP/1.1

Intestazioni della richiesta

Per altre informazioni, vedere 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 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

Se l'operazione ha esito positivo, la risposta contiene un'intestazione location con un URI che può essere usato per recuperare lo stato di aggiornamento del prodotto. Salvare questo URI per l'uso con altre API REST correlate.

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 202 Accepted
Content-Length: 0
Location: productUpgrades/42d075a4-bfe7-43e7-af6d-7c68a57edcb4
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2019 20:35:35 GMT