Udostępnij za pośrednictwem


Zaktualizuj nowy harmonogram migracji handlu

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, jak zaktualizować harmonogram migracji w ramach nowego modelu handlu. Partnerzy mogą aktualizować przed zaplanowaną datą docelową.

Ważne

Ten interfejs API jest obecnie dostępny wyłącznie w środowisku piaskownicy.

Wymagania wstępne

  • Poświadczenia opisane w Uwierzytelnianie Centrum partnerskiego. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu samodzielnych poświadczeń aplikacji, jak i poświadczeń aplikacji oraz 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
PUT {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 najemcy klienta string Tak Ciąg sformatowany za pomocą identyfikatora GUID, który identyfikuje klienta.
identyfikator harmonogramu string Tak Ciąg sformatowany w formacie GUID, który zidentyfikował harmonogram

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 Typ Wymagane Opis
obecnyIdentyfikatorSubskrypcji string Tak Identyfikator subskrypcji wskazujący, która subskrypcja wymaga weryfikacji w celu migracji. Operacja aktualizacji jest niedozwolona.
czas trwania okresu string Nie Czas trwania migracji.
billingCycle string Nie Cykl rozliczeniowy migracji.
purchaseFullTerm bool Nie Niezależnie od tego, czy migracja kontynuuje istniejący proces, czy rozpoczyna nowy.
ilość int Nie Ilość licencji dla subskrypcji można zwiększyć lub zmniejszyć podczas migracji.
zindywidualizowanaDataKońcaOkresu 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ę. Jeśli parametr targetDate jest ustawiony dla określonej daty, parametr migrationOnRenewal można ustawić na wartość null lub false.
migracjaPrzyOdnowieniu bool Nie Jeśli flaga jest ustawiona na wartość true dla elementu migrateOnRenewal, nie ma potrzeby określania wartości targetDate na potrzeby planowania migracji.

Przykład żądania

{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"status": "Created",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00"
}

Odpowiedź REST

Jeśli ta metoda powiedzie się, zwraca szczegóły migrowanych subskrypcji (obiektu migracji) w treści odpowiedzi.

Kody sukcesu 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 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ż