Naplánujte novou migraci obchodních aktivit

Článek
03/07/2025

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: Agent pro správu | Prodejní agent

Tento článek popisuje, jak naplánovat New Commerce Experience.

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 nebo přihlašovacích údajů aplikace spolu s uživatelem.
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
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
ID zákazníka-nájemce	string	Ano	Řetězec ve formátu GUID, který identifikuje zákazníka.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST rozhraní 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í pro migraci.
délka trvání	string	Ne	Po migraci je možné zadat dobu trvání, která se má změnit.
fakturační cyklus	řetězec	Ne	Fakturační cyklus je možné určit, aby se při migraci změnil.
nákup na celé období	bool	Ne	Nový termín může být zahájen v aplikaci NCE po migraci.
množství.	int	Ne	Při migraci je možné zvýšit nebo snížit množství licencí pro předplatné.
customTermEndDate	datum a čas	Ne	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
cílové datum	datum a čas	Vyžaduje se (pokud je hodnota migrateOnRenewal null nebo false).	Cílové datum, kdy naplánovat migraci Pokud je pro zadané datum nastavena hodnota targetDate, může být migrationOnRenewal nastavena na hodnotu null nebo false.
migrovat po obnovení	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	Ne	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