Weryfikowanie subskrypcji na potrzeby migracji

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 zweryfikować subskrypcję pod kątem migracji do nowego środowiska handlowego

Warunki wstępne

Poświadczenia zgodnie z opisem w uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu poświadczeń samej aplikacji, jak i aplikacji oraz 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 klient z listy klientów, a następnie konto. Na stronie Konto klienta: poszukaj identyfikatora Microsoft w sekcji Informacje o Koncie Klienta. Identyfikator Firmy Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).
Bieżący identyfikator subskrypcji

Limit szybkości

Limit API weryfikacji migracji wynosi 450 wywołań na parę partner-klient w ciągu 5 minut. Więcej informacji na temat limitów szybkości i ograniczania przepływności można znaleźć na stronie 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.

Nazwa	Typ	Wymagane	Opis
identyfikator najemcy klienta	struna	Tak	Ciąg w formacie GUID, który identyfikuje klienta.
czas trwania	struna	Nie	Czas trwania terminu można zmienić podczas migracji.
billingCycle	struna	Nie	Cykl rozliczeniowy można zmienić podczas migracji.
zakup na cały okres	bool	Nie	Po zakończeniu migracji można rozpocząć nowy okres rozliczeniowy w usłudze NCE.
ilość	Int	Nie	Ilość licencji dla subskrypcji można zwiększyć lub zmniejszyć podczas migracji.
niestandardowa data zakończenia okresu	znacznik daty i czasu	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 znajduje się tutaj: Dopasuj daty 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łasność	Typ	Wymagane	Opis
currentSubscriptionId	struna	Tak	Identyfikator subskrypcji wskazujący, która subskrypcja wymaga potwierdzenia 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 Centrum partnerskiego REST .

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