Abrufen des Produktupgradestatus für einen Kunden

  • Artikel

Sie können die ProductUpgradeRequest-Ressource verwenden, um den Status eines Upgrades auf eine neue Produktfamilie abzurufen. Diese Ressource gilt, wenn Sie einen Kunden von einem Microsoft Azure (MS-AZR-0145P)-Abonnement auf einen Azure-Plan aktualisieren. Eine erfolgreiche Anforderung gibt die ProductUpgradesEligibility-Ressource zurück.

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird die Authentifizierung mit App- und Benutzeranmeldeinformationen unterstützt. Folgen Sie dem sicheren App-Modell bei Verwendung der App+Benutzerauthentifizierung mit Partner Center-APIs.

  • 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 " und dann den Kunden aus der Kundenliste und dann "Konto" auswählen. Suchen Sie auf der Seite "Konto" des Kunden im Abschnitt "Kundenkontoinformationen" nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).

  • Die Produktfamilie.

  • Die Upgrade-ID einer Upgradeanforderung.

C#

So überprüfen Sie, ob ein Kunde berechtigt ist, ein Upgrade auf Azure-Plan durchzuführen:

  1. Erstellen Sie ein ProductUpgradesRequest-Objekt , und geben Sie den Kundenbezeichner und "Azure" als Produktfamilie an.

  2. Verwenden Sie die IAggregatePartner.ProductUpgrades-Auflistung .

  3. Rufen Sie die ById-Methode auf, und übergeben Sie die Upgrade-ID.

  4. Rufen Sie die CheckStatus-Methode auf, und übergeben Sie das ProductUpgradesRequest-Objekt , das ein ProductUpgradeStatus-Objekt zurückgibt.

// 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)
{
    ....
}

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
POST {baseURL}/v1/productUpgrades/{upgrade-id}/status HTTP/1.1

URI-Parameter

Verwenden Sie den folgenden Abfrageparameter, um den Kunden anzugeben, für den Sie einen Produktupgradestatus erhalten.

Name Type Erforderlich Beschreibung
upgrade-id GUID Ja Der Wert ist ein GUID-formatierter Upgradebezeichner. Sie können diesen Bezeichner verwenden, um ein Upgrade zum Nachverfolgen anzugeben.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Der Anforderungstext muss eine ProductUpgradeRequest-Ressource enthalten.

Beispiel für eine Anfrage

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: e3f26e6a-044f-4371-ad52-0d91ce4200be
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"
  }
}

Wichtig

Ab Juni 2023 ist jetzt die neueste Partner Center .NET SDK-Version 3.4.0 archiviert. Sie können das SDK-Release von GitHub zusammen mit einer Infodatei herunterladen, die nützliche Informationen enthält.

Partnern wird empfohlen, weiterhin die Partner Center-REST-APIs zu verwenden.

REST-Antwort

Bei erfolgreicher Ausführung gibt die Methode eine ProductUpgradesEligibility-Ressource im Textkörper zurück.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. 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.

Beispielantwort

HTTP/1.1 200 Ok
Content-Length: 150
MS-CorrelationId: 772871a9-399b-4f3b-b8c7-38f550e4f22a
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"
        }
    ]
}