Sdílet prostřednictvím

Získání nového plánu migrace komerčního obchodu

  • Článek

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 získat nový plán migrace komerčního obchodu.

Důležité

Toto rozhraní API je aktuálně dostupné jenom v tenantovi sandboxu.

Požadavky

  • Přihlašovací údaje popsané v ověřování v Partnerském centru 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

Existují dva různé způsoby, jak můžou partneři dotazovat.

  • Partneři se můžou dotazovat na získání určitého plánu.
  • Partneři se můžou dotazovat, aby získali seznam plánů pro konkrétní kritéria.

Syntaxe požadavku

Metoda Identifikátor URI požadavku
GET {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
customer-tenant-id string Ano Řetězec formátovaný identifikátorem GUID, který identifikuje zákazníka.
Metoda Identifikátor URI požadavku
GET {baseURL}/v1/migrations/newcommerce/schedules? CustomerTenantId={customer-tenant-id}

Parametr identifikátoru URI

Tato tabulka obsahuje seznam požadovaných parametrů dotazu pro vytvoření nové obchodní migrace. Lze použít každý parametr dotazu.

Název Typ Popis
customerTenantId string Řetězec formátovaný identifikátorem GUID, který identifikuje zákazníka.
currentSubscriptionID string Řetězec formátovaný identifikátorem GUID, který identifikuje aktuální ID předplatného
externalReferenceID string Řetězec formátovaný identifikátorem GUID, který identifikuje dávku migrace

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text odpovědi

Tato tabulka popisuje vlastnosti předplatného v odpovědi.

Vlastnost Typ Povinné Popis
currentSubscriptionId string Ano Identifikátor předplatného, který označuje, které předplatné vyžaduje ověření migrace.
termDuration string No Doba trvání použitá na migraci.
billingCycle string No Fakturační cyklus použitý na migraci
purchaseFullTerm bool No Bez ohledu na to, jestli migrace začíná nový termín, nebo ne.
množství. int No Při migraci je možné zvýšit nebo snížit množství licencí pro předplatné.
customTermEndDate datetime No 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
targetDate datetime No Cílové datum, kdy naplánovat migraci
migrateOnRenewal bool No Určuje, jestli se plán musí provést při prodloužení.
stav string No Stav plánované migrace
createdTime datetime No Po vytvoření plánu
lastModifiedTime datetime No Kdy byl plán naposledy změněn

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ý označuje úspěch nebo selhání s dalšími informacemi 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"
}
]

Viz také