Abrufen neuer E-Commerce-Migrationsereignisse

Artikel
10/01/2024

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

Abrufen von Details zu Migrationsereignissen basierend auf der aktuellen Abonnement-ID oder Migrations-ID

Voraussetzungen

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

Diese API kann Migrationsereignisse basierend auf Abfragezeichenfolgen abrufen, die der Partner auswählt. Die ausgewählten Abfragezeichenfolgen können die folgenden Optionen enthalten:

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)
A MigrationId (die ID des Migrationsobjekts, das dem aktuellen Abonnement zugeordnet ist)

REST-Anforderung

Anforderungssyntax

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

Abfragezeichenfolgen

In dieser Tabelle sind die Abfragezeichenfolgen aufgeführt, die zum Abrufen neuer E-Commerce-Migrationsereignisse verwendet werden können. Mindestens eine der beiden IDs ist erforderlich, um die Migrationsereignisse, die einem aktuellen Abonnement zugeordnet sind, erfolgreich abzurufen. Eingaben sowohl für die Migrations-ID als auch für die aktuelle Abonnement-ID werden akzeptiert, aber nicht erforderlich.

Name	Beschreibung
MigrationId	Eine GUID-formatierte Zeichenfolge, die das Migrationsobjekt identifiziert.
CurrentSubscriptionId	Eine GUID-formatierte Zeichenfolge, die ein migriertes Legacyabonnement identifiziert.

Anforderungsheader

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

Anforderungstext

Keine.

REST-Antwort

Wenn die Methode erfolgreich verläuft, werden Ereignisdetails des aktuellen Abonnements zurückgegeben, das im Antworttext migriert wurde.

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/customers/948ebea1-0fe5-4e45-8f2e-900288b7883e/migrations/newcommerce/events?current_subscription_id=02DF825B-D0C9-40BE-8CB6-BAC895510D0A

Beispielantworten

[
    {
        "id": "6eb07675-ba1d-45c2-9d05-c693a4863427",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "948ebea1-0fe5-4e45-8f2e-900288b7883e",
        "createdTime": "2022-06-11T00:06:02.7529574Z",
        "eventName": "MigrationStarted"
    },
    {
        "id": "e828079b-c974-4822-977e-f12ac67380db",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "948ebea1-0fe5-4e45-8f2e-900288b7883e",
        "createdTime": "2022-06-11T00:06:21.526778Z",
        "eventName": "NewCommerceSubscriptionCreated"
    },
    {
        "id": "7dbdcbd5-7a87-4d9b-bf1f-d9298493e631",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "948ebea1-0fe5-4e45-8f2e-900288b7883e",
        "createdTime": "2022-06-11T00:08:08.5185085Z",
        "eventName": "NewCommerceSubscriptionProvisioned"
    },
    {
        "id": "71a3f753-55ca-461e-807d-f541685d5c8b",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "948ebea1-0fe5-4e45-8f2e-900288b7883e",
        "createdTime": "2022-06-11T00:10:07.6947014Z",
        "eventName": "MigrationCompleted"
    }
]

Freigeben über