Weryfikowanie subskrypcji na potrzeby migracji

Artykuł
10/14/2023

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

Jak zweryfikować subskrypcję pod kątem migracji do nowego środowiska handlowego

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.
Identyfikator klienta (customer-tenant-id). 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 (customer-tenant-id).
Bieżący identyfikator subskrypcji

Limit szybkości

Limit interfejsu API weryfikacji migracji wynosi 450 wywołań na kombinację partner-klient w ciągu 5 minut. Więcej informacji na temat limitów szybkości i ograniczania przepustowości jest dostępnych w temacie Wskazówki dotyczące ograniczania przepustowości interfejsu API.

Żądanie REST

Składnia żądania

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

Parametr identyfikatora URI

W tej tabeli wymieniono wymagane parametry zapytania w celu zweryfikowania subskrypcji na potrzeby migracji.

Imię i nazwisko/nazwa	Pisz	Wymagani	opis
identyfikator dzierżawy klienta	string	Tak	Ciąg sformatowany za pomocą identyfikatora GUID, który identyfikuje klienta.
termDuration	string	Nie	Czas trwania terminu można zmienić podczas migracji.
billingCycle	string	Nie	Cykl rozliczeniowy można zmienić podczas migracji.
purchaseFullTerm	bool	Nie.	Po migracji można rozpocząć nowy termin w usłudze NCE.
quantity	int	Nie.	Ilość licencji dla subskrypcji można zwiększyć lub zmniejszyć podczas migracji.
customTermEndDate	Data i godzina	Nie.	Datę końcową można ustawić tak, aby był zgodny z istniejącą nietrialną subskrypcją usługi OnlineServicesNCE lub miesiącem kalendarzowym. Więcej informacji na temat dopasowywania dat zakończenia subskrypcji można znaleźć tutaj: Dostosowywanie dat zakończenia subskrypcji w Centrum partnerskim

Nagłówki żądań

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

Treść żądania

W tej tabeli opisano właściwości subskrypcji w treści żądania.

Właściwość	Typ	Wymagani	opis
currentSubscriptionId	string	Tak	Identyfikator subskrypcji wskazujący, która subskrypcja wymaga weryfikacji migracji.

Przykład żądania

"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"

Odpowiedź REST

Jeśli ta metoda powiedzie się, zwraca wartość logiczną "isEligible" w treści odpowiedzi, wskazując, czy bieżąca subskrypcja kwalifikuje się do migracji do nowego handlu. Należy pamiętać, że interfejs API weryfikacji migracji nie zawiera informacji dotyczących uprawnień subskrypcji do promocji w nowym handlu.

Kody powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe 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 odpowiedzi

1. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": false,
        "errors": [
            {
                "code": 5,
                "description": "Subscription cannot be migrated to New Commerce because the equivalent offer is not yet available in New Commerce",
            }
        ]
    }

2. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": true,
        "catalogItemId": "CFQ7TTC0LF8S:0002:CFQ7TTC0KSVV"
    }

Udostępnij za pośrednictwem