Naplánování nové migrace komerčního obchodu

Článek
07/02/2024

Platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Příslušné role: Globální správce | Agent pro správu | Prodejní agent

Tento článek popisuje, jak naplánovat nové komerční prostředí.

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

Syntaxe požadavku

Metoda	Identifikátor URI požadavku
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules

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.

Záhlaví žádosti

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

Text požadavku

Tato tabulka popisuje vlastnosti předplatného v textu požadavku.

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	Po migraci je možné zadat dobu trvání, která se má změnit.
billingCycle	string	No	Fakturační cyklus je možné určit, aby se při migraci změnil.
purchaseFullTerm	bool	No	Nový termín může být zahájen v aplikaci NCE po migraci.
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 je možné nastavit tak, aby odpovídalo stávajícímu předplatnému OnlineServicesNCE bez zkušební verze 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	Vyžaduje se (pokud je hodnota migrateOnRenewal null nebo false).	Cílové datum, kdy naplánovat migraci Pokud je pro zadané datum nastavená hodnota targetDate, může být migraceOnRenewal nastavena na hodnotu null nebo false.
migrateOnRenewal	bool	Povinný argument (pokud je hodnota targetDate null).	Pokud je příznak nastaven na hodnotu true pro migrateOnRenewal, není nutné zadat cílové datum pro plánování migrace.
addOnMigrationSchedules	bool	No	Obsahuje seznam předplatných doplňků, která se mají zahrnout do plánované migrace.

Příklad požadavku

{
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

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í 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": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

Sdílet prostřednictvím