Získejte vlastní termíny ukončení

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

Partneři můžou zobrazit povolená data ukončení období pro předplatná založená na licencích NCE, která si kupují pro své zákazníky. Partneři můžou zobrazit koncová data, která odpovídají konci kalendářního měsíce nebo ke společnému období se stávajícími zákaznickými předplatnými.

Rozhraní API podporují pouze výpočet vlastních termínů ukončení nákupu nových předplatných, a ne pro prodloužení platnosti stávajících předplatných.

Požadavky

• Přihlašovací údaje, jak je popsáno 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 a uživatele.

• Jeden CustomerTenantId. 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.

Požadavek REST

Syntaxe požadavku

Metoda	Identifikátor URI požadavku
DOSTAT	{baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates

Řetězce dotazů

Tato tabulka obsahuje seznam řetězců dotazů potřebných k filtrování a načítání vlastních dat ukončení termínu.

Jméno:	Požadováno	Popis:
doba trvání	Ano	Reprezentace doby trvání termínu ve formátu ISO 8601. Aktuální podporované hodnoty jsou P1M (1 měsíc), P1Y (1 rok) a P3Y (3 roky).
datum zahájení období	Ne	Zamýšlené datum nákupu. Tohle nemůže být v minulosti.
target_coterm_subscription_id	Ne	Řetězec formátovaný identifikátorem GUID, který identifikuje předplatné, se kterým se bude cotermovat.

Poznámka:

Doba trvání období P1M nebo měsíčních termínů předaných do rozhraní API vrátí výsledky společných termínů, které se nedají použít pro sladění termínů. Měsíční zarovnání se nedá použít s předplatným končícím 28. nebo 30. dnem v měsíci, pokud toto datum není posledním dnem v měsíci.

Hlavičky požadavku

Pro více informací viz záhlaví REST Partnerského centra. Odpověď rozhraní API vrátí maximálně 300 stránkových záznamů. Pokud se ve vstupním dotazu vrátí více než 300 záznamů, v hlavičce odpovědi se zobrazí token pro pokračování. Token pro pokračování lze vložit do hlavičky následujícího požadavku, aby se vrátily další stránky záznamů dle požadavku.

Text požadavku

Žádný.

Odpověď REST

V případě úspěchu vrátí tato metoda podrobnosti o Předplatných migrovaných (objekt migrace) v textu odpovědi. To zahrnuje ID migrace.

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 chybové kódy rozhraní REST Partnerského centra.

Příklady adres URL požadavku

baseurl/v1/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M

Příklady odpovědí

 {​
    "totalCount": 2,​
    "items": [​
        {​
            "allowedCustomTermEndDateType": "calendarMonthAligned",​
            "allowedCustomTermEndDate": "2023-07-31T00:00:00"​
        },​
        {​
            "allowedCustomTermEndDateType": "subscriptionAligned",​
            "cotermSubscriptionIds": [​
               "5fcf618b-1daa-4604-da99-cc3e1c9ee422",​
               "d30a9ff9-713e-4546-c97e-f06b9dcf6ef6"​
            ],​
            "allowedCustomTermEndDate": "2023-08-01T00:00:00"​
        }​
    ],​
    "links": {​
        "self": {​
            "uri": "/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M",​
            "method": "GET",​
            "headers": []​
        }​
    },​
    "attributes": {​
        "objectType": "Collection"​
    }​
 }