Planowanie nowej migracji handlowej
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 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 | string | 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 | string | Tak | Identyfikator subskrypcji wskazujący, która subskrypcja wymaga weryfikacji migracji. |
| termDuration | 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. |
| purchaseFullTerm | bool | Nie. | Po migracji można rozpocząć nowy termin w usłudze NCE. |
| ilość | int | Nie. | Ilość licencji dla subskrypcji można zwiększyć lub zmniejszyć podczas migracji. |
| customTermEndDate | datetime | 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 | datetime | 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
}
]
}