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

Articolo
10/01/2024

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

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 a cui si vuole aggiornare il cliente.

C#

Per aggiornare un cliente 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 Create e passare l'oggetto ProductUpgradesRequest, che restituirà una stringa di intestazione della posizione.
Estrarre l'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

Method	URI della richiesta
POST	{baseURL}/v1/productupgrades HTTP/1.1

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

Condividi tramite