Planowanie nowej migracji handlowej

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

Odpowiednie role: Agent administracyjny | Agent sprzedaży

W tym artykule opisano, jak zaplanować harmonogram Nowego Doświadczenia 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	Żądanie URI
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	Typ	Wymagane	Opis
identyfikator klienta najemcy	string	Tak	Ciąg sformatowany za pomocą identyfikatora GUID, który identyfikuje klienta.

Nagłówki żądań

Aby uzyskać więcej informacji, zapoznaj się z nagłówkami REST w Centrum partnerskim.

Treść żądania

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

Własność	Typ	Wymagane	Opis
aktualnaIdentyfikatorSubskrypcji	string	Tak	Identyfikator subskrypcji, który wskazuje, która subskrypcja wymaga weryfikacji w celu migracji.
czas trwania	string	Nie	Czas trwania terminu można określić do zmiany podczas migracji.
billingCycle	string	Nie	Cykl rozliczeniowy można określić do zmiany podczas migracji.
zakup pełnego okresu	bool	Nie	Po migracji można rozpocząć nowy okres w ramach NCE.
ilość	int	Nie	Ilość licencji dla subskrypcji można zwiększyć lub zmniejszyć podczas migracji.
customTermEndDate	data i czas	Nie	Datę zakończenia można ustawić, aby dopasować do istniejącej subskrypcji OnlineServicesNCE innej niż wersja próbna lub miesiąca kalendarzowego. Więcej informacji na temat dopasowywania dat zakończenia subskrypcji można znaleźć tutaj: Dostosowywanie dat zakończenia subskrypcji w Centrum partnerskim
data docelowa	data i czas	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.
migrujPrzyOdnowieniu	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 sukcesu i błędu 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 Partnerów.

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