Wykonywanie zapytań dotyczących nowych migracji handlowych

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

Jak wykonywać zapytania dotyczące zmigrowanych subskrypcji na podstawie identyfikatora klienta, bieżącego identyfikatora subskrypcji lub zewnętrznego identyfikatora referencyjnego

Odpowiednie role: administrator globalny | agent Administracja | Agent sprzedaży

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 filtrować na podstawie ciągów zapytania wybranych przez partnera. Wybrane ciągi zapytania mogą być dowolną z następujących trzech opcji:

• 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)

• ExternalReferenceId (identyfikator partii zwrócony przez narzędzie do migracji usługi Batch, który jest dostępny do pobrania za pośrednictwem zestawu SDK Centrum partnerskiego)

Żądanie REST

Składnia żądania

Metoda	Identyfikator URI żądania
GET	{baseURL}/v1/migrations/newcommerce HTTP/1.1

Ciągi zapytania

W tej tabeli wymieniono ciągi zapytania potrzebne do filtrowania i pobierania nowych migracji handlowych. Co najmniej jeden z trzech identyfikatorów jest wymagany do pomyślnego wykonywania zapytań dotyczących migracji. Wprowadzanie wielu identyfikatorów do zapytania jest akceptowane, ale nie jest wymagane.

Nazwa/nazwisko	opis
CustomerTenantId	Ciąg sformatowany za pomocą identyfikatora GUID, który identyfikuje klienta.
CurrentSubscriptionId	Ciąg sformatowany przez identyfikator GUID, który identyfikuje zmigrowaną starszą subskrypcję.
ExternalReferenceId	Ciąg sformatowany przez identyfikator GUID, który identyfikuje partię migracji.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego. Odpowiedź interfejsu API zwraca maksymalnie 300 rekordów stron. Jeśli w zapytaniu wejściowym zostanie zwróconych ponad 300 rekordów, w nagłówku odpowiedzi zostanie podany token kontynuacji. Token kontynuacji może być wejściowy w nagłówku następującego żądania, aby zwrócić dodatkowe rekordy stron, których dotyczy zapytanie.

Treść żądania

Brak.

Odpowiedź REST

Jeśli ta metoda powiedzie się, zwraca szczegóły subskrypcji , które zostały zmigrowane (obiekt migracji) w treści odpowiedzi. Obejmuje to identyfikator migracji.

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/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

Przykłady odpowiedzi

[
{
"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"
}
]