Abfragen von Migrationen zum neuen E-Commerce-Verfahren

  • Artikel

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

Abfragen nach migrierten Abonnements basierend auf Kunden-ID, aktueller Abonnement-ID oder externer Referenz-ID

Geeignete Rollen:Administrator-Agent | Administrator-Agent | Vertriebsbeauftragter

Voraussetzungen

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

Diese API kann basierend auf Abfragezeichenfolgen filtern, die der Partner auswählt. Ausgewählte Abfragezeichenfolgen können eine der folgenden drei Optionen sein:

  • Eine CustomerTenantId. 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 ist identisch mit der Kunden-ID.

  • Eine CurrentSubscriptionId (die Legacy-ID für ein Abonnement, das migriert wurde)

  • Eine ExternalReferenceId (die Batch-ID, die vom Batchmigrationstool zurückgegeben wird, das über das Partner Center SDK heruntergeladen werden kann)

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
GET {baseURL}/v1/migrations/newcommerce HTTP/1.1

Abfragezeichenfolgen

In dieser Tabelle sind die Abfragezeichenfolgen aufgeführt, die zum Filtern und Abrufen neuer Commerce-Migrationen erforderlich sind. Mindestens eine der drei IDs ist erforderlich, um Migrationen erfolgreich abzufragen. Das Eingeben mehrerer IDs zur Abfrage wird akzeptiert, aber nicht erforderlich.

Name Beschreibung
CustomerTenantId Eine GUID-formatierte Zeichenfolge, die den Kunden identifiziert.
CurrentSubscriptionId Eine GUID-formatierte Zeichenfolge, die ein migriertes Legacyabonnement identifiziert.
ExternalReferenceId Eine GUID-formatierte Zeichenfolge, die den Migrationsbatch identifiziert.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header. Die Antwort der API gibt maximal 300 Seitendatensätze zurück. Wenn in einer eingegebenen Abfrage mehr als 300 Datensätze zurückgegeben werden, wird ein Fortsetzungstoken im Antwortheader bereitgestellt. Das Fortsetzungstoken kann in der Kopfzeile einer folgenden Anforderung eingegeben werden, um zusätzliche Seitendatensätze zurückzugeben, die abgefragt wurden.

Anforderungstext

Keine.

REST-Antwort

Wenn die Methode erfolgreich verläuft, werden Details der Abonnements zurückgegeben, die migriert wurden (Migrationsobjekt) im Antworttext. Dies schließt die Migrations-ID ein.

Erfolgs- und Fehlercodes der Antwort

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

Beispiele für Anforderungs-URL

baseurl/v1/migrations/newcommerce?CustomerTenantId=83c51838-fed5-44a4-a275-afa201d53699&CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833&ExternalReferenceId=9ab61899-0b2b-4320-bd6d-8196c53607d6

baseurl/v1/migrations/newcommerce?CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833

Beispielantworten

[
{
"addOnMigrations": [],
"id": "8ce7115e-0324-41b1-8ca3-7c7ae3b64f75",
"startedTime": "2022-02-24T23:50:30.4384819Z",
"completedTime": "2022-02-24T23:53:14.0813711Z",
"currentSubscriptionId": "9E289691-2FF3-419D-B39B-26B3E5A817FB",
"status": "Completed",
"customerTenantId": "ce6fcc21-c276-447b-9605-874decb9024b",
"catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
"newCommerceSubscriptionId": "f2d6534b-9e30-4cf5-c7b0-5d6393dbf12d",
"newCommerceOrderId": "09714c93092a",
"subscriptionEndDate": "2023-02-14T00:00:00Z",
"quantity": 2,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"externalReferenceId": "771317a4-275d-47d9-9724-3eefa4a168ad"
}
]