Erstellen einer Produktupgradeentität für einen Kunden

Sie können eine Produktupgradeentität erstellen, um einen Kunden mithilfe der ProductUpgradeRequest-Ressource auf eine bestimmte Produktfamilie (z. B. einen Azure-Plan) zu aktualisieren.

Voraussetzungen

• Anmeldeinformationen wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit App- und Benutzeranmeldeinformationen. Befolgen Sie das sichere App-Modell , wenn Sie die App+Benutzerauthentifizierung mit Partner Center-APIs verwenden.

• Eine Kunden-ID (customer-tenant-id). Wenn Sie die Kunden-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich Kunden auswählen, dann den Kunden aus der Kundenliste und anschließend Konto. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID ist identisch mit der Kunden-ID (customer-tenant-id).

• Die Produktfamilie, auf die Sie den Kunden aktualisieren möchten.

C#

So führen Sie ein Upgrade eines Kunden auf einen Azure-Plan durch:

1. Erstellen Sie ein ProductUpgradesRequest-Objekt, und geben Sie die Kunden-ID und "Azure" als Produktfamilie an.

2. Verwenden Sie die IAggregatePartner.ProductUpgrades-Auflistung .

3. Rufen Sie die Create-Methode auf, und übergeben Sie das ProductUpgradesRequest-Objekt , das eine Headerzeichenfolge für den Standort zurückgibt.

4. Extrahieren Sie die upgrade-id aus der Headerzeichenfolge location, die zum Abfragen des Upgradestatus verwendet werden kann.

// 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];

REST-Anforderung

Anforderungssyntax

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center REST-Header.

Anfragekörper

Der Anforderungstext muss eine ProductUpgradeRequest-Ressource enthalten.

Beispielanfrage

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

REST-Antwort

Bei erfolgreicher Ausführung enthält die Antwort einen Location-Header mit einem URI, der zum Abrufen des Produktupgrade-Status verwendet werden kann. Speichern Sie diesen URI für die Verwendung mit anderen verwandten REST-APIs.

Antworterfolgs- und Fehlercodes

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler sowie zusätzliche Debuginformationen angibt. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Antwortbeispiel

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