Sdílet prostřednictvím


Naplánování nové 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

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í.

Předpoklady

  • 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

Method 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.

Name Typ Povinné Popis
customer-tenant-id řetězec 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 řetězec Ano Identifikátor předplatného, který označuje, které předplatné vyžaduje ověření migrace.
termDuration řetězec No Po migraci je možné zadat dobu trvání, která se má změnit.
billingCycle řetězec 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.
quantity 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
        }
    ]
}

Viz také