Überprüfen eines Abonnements für die Migration

  • Artikel

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

So überprüfen Sie ein Abonnement für die Migration zu New Commerce Experience

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.

  • 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 Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).

  • Aktuelle Abonnement-ID

Rate Limit

Der Grenzwert für die Validierungsmigrations-API beträgt 450 Anrufe pro Partnerkundenkombination in 5 Minuten. Weitere Informationen zu Ratelimits und Drosselung finden Sie unter API-Einschränkungsleitfaden.

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
POST {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/validate HTTP/1.1

URI-Parameter

In dieser Tabelle sind die erforderlichen Abfrageparameter aufgeführt, um ein Abonnement für die Migration zu überprüfen.

Name Type Erforderlich Beschreibung
customer-tenant-id Zeichenfolge Ja Eine GUID-formatierte Zeichenfolge, die den Kunden identifiziert.
termDuration Zeichenfolge Nein Die Laufzeitdauer kann bei der Migration geändert werden.
billingCycle Zeichenfolge Nein Der Abrechnungszyklus kann bei der Migration geändert werden.
purchaseFullTerm bool Nein Ein neuer Begriff kann bei der Migration in NCE gestartet werden.
Menge INT Nein Die Lizenzmenge für ein Abonnement kann bei der Migration erhöht oder verringert werden.
customTermEndDate datetime Nein Ein Enddatum kann so festgelegt werden, dass es an einem vorhandenen nichttrialen OnlineServicesNCE-Abonnement oder kalendermonat ausgerichtet ist. Weitere Informationen zum Ausrichten der Enddaten des Abonnements finden Sie hier: Ausrichten der Enddaten des Abonnements im Partner Center

Anforderungsheader

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

Anforderungstext

In dieser Tabelle werden die Abonnementeigenschaften im Anforderungstext beschrieben.

Eigenschaft Type Erforderlich Beschreibung
currentSubscriptionId Zeichenfolge Ja Ein Abonnementbezeichner, der angibt, welches Abonnement eine Überprüfung für die Migration erfordert.

Beispiel für eine Anfrage

"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"

REST-Antwort

Wenn die Methode erfolgreich verläuft, wird ein boolescher Wert vom Typ "isEligible" im Antworttext zurückgegeben, der angibt, ob das aktuelle Abonnement für die Migration zu einem neuen Commerce berechtigt ist. Beachten Sie, dass die Validate-Migrations-API keine Informationen zur Berechtigung eines Abonnements für Werbeaktionen in New Commerce bereitstellt.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss über Erfolg oder Fehler und zusätzliche Debuginformationen gibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und andere Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Beispielantworten

1. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": false,
        "errors": [
            {
                "code": 5,
                "description": "Subscription cannot be migrated to New Commerce because the equivalent offer is not yet available in New Commerce",
            }
        ]
    }

2. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": true,
        "catalogItemId": "CFQ7TTC0LF8S:0002:CFQ7TTC0KSVV"
    }