Pobierz nowe zdarzenia związane z migracją handlową

Artykuł
03/09/2025

Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA

Jak uzyskać szczegółowe informacje o zdarzeniach migracji na podstawie bieżącego identyfikatora subskrypcji lub identyfikatora migracji

Warunki wstępne

Poświadczenia zgodnie z opisem w uwierzytelnianie Centrum Partnerskiego. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu poświadczeń samej aplikacji, jak i aplikacji oraz użytkownika.

Ten interfejs API może pobierać zdarzenia migracji na podstawie ciągów zapytań wybranych przez partnera. Wybrane ciągi zapytania mogą zawierać następujące opcje:

IdentyfikatorNajemcyKlienta. Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w centrum partnerskim , wybierając obszar roboczy Klienci, a następnie klient z listy klientów, a następnie konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji informacje o koncie klienta . Identyfikator Microsoft jest taki sam jak identyfikator klienta.
CurrentSubscriptionId (starszy identyfikator subskrypcji, która została zmigrowana)
Identyfikator MigrationId (identyfikator obiektu migracji skojarzony z bieżącą subskrypcją)

Żądanie REST

Składnia żądania

Metoda	Identyfikator URI żądania
GET	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/events HTTP/1.1

Ciągi zapytania

W tej tabeli wymieniono ciągi zapytań, których można użyć do pobierania nowych zdarzeń migracji w handlu. Co najmniej jeden z dwóch identyfikatorów jest wymagany do pomyślnego pobrania wydarzeń migracyjnych skojarzonych z bieżącą subskrypcją. Wprowadzanie zarówno identyfikatora migracji, jak i bieżącego identyfikatora subskrypcji jest akceptowane, ale nie jest wymagane.

Nazwa	Opis
Identyfikator migracji	Ciąg w formacie identyfikatora GUID, który identyfikuje obiekt migracji.
CurrentSubscriptionId	Ciąg w formacie GUID, który identyfikuje zmigrowaną legacy subskrypcję.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Żaden.

Odpowiedź REST

Jeśli ta metoda powiedzie się, zwraca szczegóły zdarzenia bieżącej subskrypcji, które zostały zmigrowane w treści odpowiedzi.

Kody sukcesu i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i inne informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i inne parametry. Aby uzyskać pełną listę, zobacz kody błędów REST Partner Center .

Przykłady adresów URL żądań

baseurl/v1/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/migrations/newcommerce/events?current_subscription_id=02DF825B-D0C9-40BE-8CB6-BAC895510D0A

Przykłady odpowiedzi

[
    {
        "id": "6eb07675-ba1d-45c2-9d05-c693a4863427",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "createdTime": "2022-06-11T00:10:07.6947014Z",
        "eventName": "MigrationCompleted"
    }
]

Udostępnij za pośrednictwem