Aktualizace nového plánu migrace komerčního obchodu
Platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA
Tento článek popisuje, jak aktualizovat nový plán migrace obchodu. Partneři se mohou aktualizovat před plánovaným cílovým datem.
Důležité
Toto rozhraní API je aktuálně dostupné pouze v tenantovi Sandboxu.
Požadavky
Přihlašovací údaje, jak je popsáno v ověřování Partnerského centra. Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.
ID zákazníka (
customer-tenant-id
). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id
).Aktuální ID předplatného
Požadavek REST
Syntaxe požadavku
Metoda | Požadavek URI |
---|---|
PUT | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID} |
Parametr identifikátoru URI
Tato tabulka obsahuje seznam požadovaných parametrů dotazu pro vytvoření nové obchodní migrace.
Název | Typ | Povinné | Popis |
---|---|---|---|
identifikátor zákaznického nájemce | řetězec | Ano | Řetězec ve formátu GUID, který identifikuje zákazníka. |
scheduleID | řetězec | Ano | Řetězec ve formátu GUID, který identifikoval plán |
Záhlaví žádosti
Pro více informací si přečtěte Hlavičky REST Partnerského centra.
Text požadavku
Tato tabulka popisuje vlastnosti předplatného v textu požadavku.
Vlastnost | Typ | Povinné | Popis |
---|---|---|---|
aktuálníSubscriptionId | řetězec | Ano | Identifikátor předplatného, který označuje, které předplatné vyžaduje ověření pro migraci. Není povoleno provádět operaci aktualizace. |
délka období | řetězec | Ne | Doba trvání migrace. |
fakturační cyklus | string | Ne | Fakturační cyklus migrace |
nákup celého období | bool | Ne | Bez ohledu na to, jestli migrace pokračuje ve stávajícím platném období, nebo zahájí nové. |
množství. | int | Ne | Při migraci je možné zvýšit nebo snížit množství licencí pro předplatné. |
individuálníDatumKonceSmlouvy | datum a čas | Ne | Koncové datum lze nastavit tak, aby odpovídalo stávajícímu nekonstrukčnímu předplatnému OnlineServicesNCE nebo kalendářnímu měsíci. Další informace o sladění koncových dat předplatného najdete tady: Sladění koncových dat předplatného v Partnerském centru |
cílové datum | datum a čas | Ne | Cílové datum, kdy naplánovat migraci Pokud je pro zadané datum nastaven targetDate, lze migrationOnRenewal nastavit na null nebo false. |
migrovatPoObnovení | bool | Ne | Pokud je příznak nastavený na hodnotu true pro migrateOnRenewal, není nutné pro plánování migrace specifikovat cílové datum. |
Příklad požadavku
{
"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"
}
Odpověď REST
V případě úspěchu vrátí tato metoda podrobnosti o migrovaných předplatných (objekt migrace) v textu odpovědi.
Kódy úspěšnosti a chyb odpovědi
Každá odpověď obsahuje stavový kód HTTP, který indikuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.
Příklady odpovědí
{
"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"
}