Uzyskaj nowy harmonogram migracji handlowej
Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA
W tym artykule opisano sposób uzyskiwania nowego harmonogramu migracji do handlu.
Ważne
Ten interfejs API jest obecnie dostępny tylko w środowisku testowym.
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
Istnieją dwa różne sposoby wykonywania zapytań przez partnerów.
- Partnerzy mogą wykonywać zapytania w celu uzyskania określonego harmonogramu
- Partnerzy mogą wysyłać zapytania, aby uzyskać listę harmonogramów dla określonych kryteriów
Składnia żądania
| Metoda | URI żądania |
|---|---|
| GET | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID} |
Parametr identyfikatora URI
W tej tabeli wymieniono wymagane parametry zapytania w celu utworzenia nowej migracji handlowej.
| Nazwa/nazwisko | Typ | Wymagane | Opis |
|---|---|---|---|
| identyfikator klienta-dzierżawy | string | Tak | Ciąg w formacie GUID, który identyfikuje klienta. |
| Metoda | Identyfikator URI żądania |
|---|---|
| GET | {baseURL}/v1/migrations/newcommerce/schedules? CustomerTenantId={customer-tenant-id} |
Parametr identyfikatora URI
W tej tabeli wymieniono wymagane parametry zapytania w celu utworzenia nowej migracji handlowej. Można użyć każdego parametru zapytania.
| Nazwa/nazwisko | Typ | Opis |
|---|---|---|
| customerTenantId | string | Ciąg w formacie GUID, który identyfikuje klienta. |
| currentSubscriptionID | string | Ciąg sformatowany w formacie GUID, który identyfikuje bieżący identyfikator subskrypcji |
| zewnętrzny identyfikator odniesienia | string | Ciąg w formacie GUID identyfikujący partię migracji |
Nagłówki żądań
Aby uzyskać więcej informacji, zobacz Nagłówki REST w Centrum partnerskim.
Treść odpowiedzi
W tej tabeli opisano właściwości subskrypcji w odpowiedzi.
| Właściwości | Typ | Wymagane | Opis |
|---|---|---|---|
| bieżącyIdentyfikatorSubskrypcji | string | Tak | Identyfikator subskrypcji, który wskazuje, którą subskrypcję należy potwierdzić do migracji. |
| czas trwania | string | Nie | Czas trwania terminu stosowany do migracji. |
| billingCycle | string | Nie | Cykl rozliczeniowy zastosowany do migracji. |
| zakup na cały okres | bool | Nie | Bez względu na to, czy migracja rozpoczyna nowy termin, czy nie. |
| ilość | int | Nie | Ilość licencji dla subskrypcji można zwiększyć lub zmniejszyć podczas migracji. |
| customTermEndDate | data i czas | 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 |
| data docelowa | data i czas | Nie | Data docelowa, kiedy zaplanować migrację. |
| migrateOnRenewal | bool | Nie | Wskazuje, czy harmonogram musi nastąpić po odnowieniu |
| stan | string | Nie | Status migracji harmonogramu |
| czasUtworzenia | data i czas | Nie | Po utworzeniu harmonogramu |
| czasOstatniejModyfikacji | data i godzina | Nie | Kiedy harmonogram został ostatnio zmodyfikowany |
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 z dalszymi informacjami 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 partnera.
Przykłady odpowiedzi
[
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00",
"createdTime": "2022-10-18T21:20:50.9668605+00:00",
"lastModifiedTime": "2022-10-18T21:29:32.8992819+00:00"
}
]