Udostępnij za pośrednictwem

Pobieranie nowego harmonogramu migracji do handlu

  • Artykuł

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 dzierżawie piaskownicy.

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 Identyfikator 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 Type Wymagane Opis
identyfikator dzierżawy klienta string Tak Ciąg sformatowany za pomocą identyfikatora 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 sformatowany za pomocą identyfikatora GUID, który identyfikuje klienta.
currentSubscriptionID string Ciąg sformatowany w formacie GUID, który identyfikuje bieżący identyfikator subskrypcji
externalReferenceID string Ciąg sformatowany przez identyfikator GUID identyfikujący partię migracji

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść odpowiedzi

W tej tabeli opisano właściwości subskrypcji w odpowiedzi.

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 stosowany do migracji.
billingCycle string Nie Cykl rozliczeniowy zastosowany do migracji.
purchaseFullTerm 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 datetime 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
targetDate datetime Nie. Data docelowa, kiedy zaplanować migrację.
migrateOnRenewal bool Nie. Wskazuje, czy harmonogram musi nastąpić po odnowieniu
status string Nie Stan migracji harmonogramu
createdTime datetime Nie. Po utworzeniu harmonogramu
lastModifiedTime datetime 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 partnerskiego.

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"
}
]

Zobacz też