Získání vlastních dat ukončení termínu

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

• A 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 účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka.

Požadavek REST

Syntaxe požadavku

metoda	Identifikátor URI žádosti
GET	{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.

Název:	Požaduje se:	Popis:
term_duration	Ano	Reprezentace doby trvání období iso 8601. Aktuální podporované hodnoty jsou P1M (1 měsíc), P1Y (1 rok) a P3Y (3 roky).
term_start_date	No	Zamýšlené datum nákupu. Tohle nemůže být v minulosti.
target_coterm_subscription_id	No	Řetězec formátovaný identifikátorem GUID, který identifikuje předplatné, se kterým se bude cotermovat.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky 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í může být vstupní v hlavičce následujícího požadavku, aby se vrátily další záznamy stránek dotazované.

Text požadavku

Nezaokrouhlovat.

Odpověď REST

V případě úspěchu vrátí tato metoda podrobnosti o předplatných , která byla migrována (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 Kódy chyb REST v Partnerském centru.

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"​
    }​
 }