Planowanie nowej migracji handlowej

Artykuł
07/25/2023

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

Odpowiednie role: administrator globalny | Agent administracyjny | Agent sprzedaży

W tym artykule opisano sposób planowania 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

Żądanie REST

Składnia żądania

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

Parametr identyfikatora URI

W tej tabeli wymieniono wymagane parametry zapytania w celu utworzenia nowej migracji handlowej.

Nazwa/nazwisko	Type	Wymagane	Opis
identyfikator dzierżawy klienta	ciąg	Tak	Ciąg sformatowany za pomocą identyfikatora GUID, który identyfikuje klienta.

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ści	Type	Wymagane	Opis
currentSubscriptionId	ciąg	Tak	Identyfikator subskrypcji wskazujący, która subskrypcja wymaga weryfikacji migracji.
termDuration	ciąg	Nie	Czas trwania terminu można określić do zmiany podczas migracji.
billingCycle	ciąg	Nie	Cykl rozliczeniowy można określić do zmiany 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ę zakończenia można ustawić tak, aby był zgodny z istniejącą subskrypcją OnlineServicesNCE inną niż wersja próbna lub miesiąc kalendarzowy. Więcej informacji na temat dopasowywania dat zakończenia subskrypcji można znaleźć tutaj: Dostosowywanie dat zakończenia subskrypcji w Centrum partnerskim
targetDate	Data i godzina	Wymagane (jeśli wartość migrateOnRenewal ma wartość null/false)	Data docelowa, kiedy zaplanować migrację. Jeśli parametr targetDate jest ustawiony dla określonej daty, parametr migrationOnRenewal można ustawić na wartość null lub false.
migrateOnRenewal	bool	Wymagane (jeśli wartość targetDate ma wartość null)	Jeśli flaga jest ustawiona na wartość true dla elementu migrateOnRenewal, nie ma potrzeby określania wartości targetDate na potrzeby planowania migracji.
addOnMigrationSchedules	bool	Nie	Zawiera listę subskrypcji Dodatków, które mają zostać uwzględnione w zaplanowanej migracji.

Przykład żądania

{
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

Odpowiedź REST

Jeśli ta metoda powiedzie się, zwraca szczegóły migrowanych subskrypcji (obiektu migracji) 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 dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.

Przykłady odpowiedzi

{
    "id": "f016c025-a873-47af-8b52-2516fbef4c65",
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

Udostępnij za pośrednictwem