Pobieranie nowych zdarzeń migracji do handlu

Artykuł
10/01/2024

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

Wymagania wstępne

Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i 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:

A CustomerTenantId. Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w Centrum partnerskim, wybierając obszar roboczy Klienci , a następnie klienta z listy klienta, a następnie pozycję 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 do handlu. Co najmniej jeden z dwóch identyfikatorów jest wymagany do pomyślnego pobrania zdarzeń migracji skojarzonych z bieżącą subskrypcją. Wprowadzanie zarówno identyfikatora migracji, jak i bieżącego identyfikatora subskrypcji jest akceptowane, ale nie jest wymagane.

Nazwa/nazwisko	opis
Identyfikator migracji	Ciąg sformatowany przez identyfikator GUID, który identyfikuje obiekt migracji.
CurrentSubscriptionId	Ciąg sformatowany przez identyfikator GUID, który identyfikuje zmigrowaną starszą subskrypcję.

Nagłówki żądań

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

Treść żądania

Brak.

Odpowiedź REST

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

Kody powodzenia 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 Centrum partnerskiego.

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