Abfragen von Migrationen zum neuen E-Commerce-Verfahren
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"
}
]