Vytvořit novou obchodní migraci

Č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

Jak vytvořit migraci předplatného do Nového obchodního zážitku

Požadavky

Pověř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 a přihlašovacích údajů aplikace 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 zákaznickém účtu. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).
Aktuální ID předplatného

Limit rychlosti

Limit rozhraní API pro vytvoření migrace je 100 volání partnera za 5 minut. Další informace o omezení rychlosti a regulaci jsou k dispozici v pokynech k omezování rozhraní API.

Požadavek REST

Syntaxe požadavku

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

Parametr identifikátoru URI

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

Jméno	Typ	Požadovaný	Popis
zákazník-nájemce-id	řetězec	Ano	Řetězec ve formátu GUID, který identifikuje zákazníka.

Hlavičky požadavku

Další informace naleznete v části Hlavičky REST Partnerského centra.

Text požadavku

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

Vlastnost	Typ	Požadovaný	Popis
AktuálníSubscriptionId	řetězec	Ano	Identifikátor předplatného, který označuje, které předplatné vyžaduje ověření pro migraci.
doba trvání	řetězec	Ne	Dobu trvání je možné po migraci změnit.
fakturační cyklus	řetězec	Ne	Fakturační cyklus je možné po migraci změnit.
nákup celé doby trvání	Bool	Ne	Nové období může být zahájeno v 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 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

Příklad požadavku

Poznámka: Vnořené doplňky (předplatná doplňků s předplatnými doplňků) by měly být zapsány v textu požadavku jako plochý seznam v rámci doplňků AddOnMigrations a neměly by být vnořené do jiných předplatných doplňků v požadavku; Podívejte se na příklad posledního požadavku, jak se doplňky dají zapsat do textu požadavku.

{
    "currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"
}

{ 
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "termDuration": "P1M", 
    "billingCycle": "Monthly", 
}

{
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "purchaseFullTerm": true 
}

{
    "currentSubscriptionId": "66E738D6-E0BC-4FFB-8818-BDE99BC7008B",
    "quantity": 1,
    "billingCycle": "Annual",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "359011DC-B5B0-4660-850B-A8FA9B2E3309",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M"
        },
        {
            "currentSubscriptionId": "159D9F87-CE39-4EBD-B9C2-ECF0892A85A1",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y"
        }
    ]
}

Odpověď REST

Pokud je tato metoda úspěšná, vrátí podrobnosti o migrovaných předplatných (objekt migrace) v těle 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 ROZHRANÍ REST v Partnerském centru.

Příklady odpovědí

{
    "addOnMigrations": [
        {
            "currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LH0T:0001:CFQ7TTC0K4KQ",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "80906BD9-E45C-4D1B-92A8-EA3F3FB6E105",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LH0R:0001:CFQ7TTC0K0SK",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "72E424F4-10FF-4C76-B101-C274F73BA498",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LHXJ:0001:CFQ7TTC0KHTR",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        }
    ],
    "id": "7123c075-fc05-42d6-a21e-1d2036fa490b",
    "startedTime": "2022-02-23T13:00:48.4489832Z",
    "currentSubscriptionId": "2E56C7F5-E120-4CA4-BFF3-7DA763B4D777",
    "status": "Processing",
    "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}

Sdílet prostřednictvím