Überprüfen eines Abonnements für die Migration

Artikel
10/28/2024

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

Ratenbegrenzung

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	No	Die Laufzeitdauer kann bei der Migration geändert werden.
billingCycle	Zeichenfolge	No	Der Abrechnungszyklus kann bei der Migration geändert werden.
purchaseFullTerm	bool	No	Ein neuer Begriff kann bei der Migration in NCE gestartet werden.
Menge	int	No	Die Lizenzmenge für ein Abonnement kann bei der Migration erhöht oder verringert werden.
customTermEndDate	datetime	No	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.

Anforderungsbeispiel

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

Teilen über