Ověření předplatného pro migraci

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

Jak ověřit předplatné pro migraci do New Commerce Experience

Požadavky

• Přihlašovací údaje popsané v ověřování v Partnerském centru. Tento scénář podporuje ověřování pomocí jak samostatných přihlašovacích údajů aplikace, tak i přihlašovacích údajů 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 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 ověření migrace je 450 volání na kombinaci partnera a zákazníka za 5 minut. Další informace o omezeních rychlosti a omezování jsou k dispozici v pokyny 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/validate HTTP/1.1

Parametr identifikátoru URI

Tato tabulka obsahuje seznam požadovaných parametrů dotazu pro ověření předplatného pro migraci.

Jméno	Typ	Povinný	Popis
ID nájemce zákazníka	řetězec	Ano	Řetězec ve formátu GUID, který identifikuje zákazníka.
délka 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 na celé období	bool	Ne	Nové období může být zahájeno v systému NCE po migraci.
množství	Int	Ne	Při migraci je možné zvýšit nebo snížit množství licencí pro předplatné.
vlastníDatumUkončeníTermínu	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

Hlavičky požadavku

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	Požadovaný	Popis
currentSubscriptionId	řetězec	Ano	Identifikátor předplatného, který určuje, které předplatné vyžaduje ověření pro migraci.

Příklad požadavku

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

Odpověď REST

Pokud je tato metoda úspěšná, vrátí v textu odpovědi logickou hodnotu "isEligible", která indikuje, jestli aktuální předplatné má nárok na migraci na nový obchod. Upozorňujeme, že rozhraní API pro ověření migrace neposkytuje informace týkající se způsobilosti předplatného pro propagační akce v novém obchodu.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď se dodává se stavovým kódem 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ě. Pro úplný seznam si přečtěte kódy chyb rozhraní REST v partnerském centru u.

Příklady odpovědí

1. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": false,
        "errors": [
            {
                "code": 5,
                "description": "Subscription cannot be migrated to New Commerce because the equivalent offer is not yet available in New Commerce",
            }
        ]
    }

2. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": true,
        "catalogItemId": "CFQ7TTC0LF8S:0002:CFQ7TTC0KSVV"
    }