Egyéni kifejezés záródátumának lekérése

A következőre vonatkozik: Partnerközpont | A 21Vianet által üzemeltetett Partnerközpont | Partnerközpont a Microsoft Cloud for US Government számára

A partnerek megtekinthetik az ügyfelek számára vásárolt NCE licencalapú előfizetések engedélyezett egyéni kifejezésvégzítési dátumát. A partnerek megtekinthetik a naptári hónap végéhez vagy a meglévő ügyfél-előfizetésekhez kapcsolódó záró dátumokat.

Az API-k csak az új előfizetések vásárlásához és a meglévő előfizetések megújításához nem támogatják az egyéni lejárati dátumok kiszámítását.

Előfeltételek

• Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja az önálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.

• A CustomerTenantId. Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából, majd a Fiók listában. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval.

REST-kérés

Kérés szintaxisa

Metódus	Kérés URI-ja
GET	{baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates

Lekérdezési sztringek

Ez a táblázat felsorolja az egyéni kifejezésvégdátumok szűréséhez és lekéréséhez szükséges lekérdezési sztringeket.

Név:	Szükséges:	Leírás:
term_duration	Igen	A kifejezés időtartamának ISO 8601-es ábrázolása. Az aktuális támogatott értékek a P1M (1 hónap), a P1Y (1 év) és a P3Y (3 év).
term_start_date	Nem	A vásárlás tervezett dátuma. Ez nem lehet a múltban.
target_coterm_subscription_id	Nem	GUID formátumú sztring, amely azonosítja a társtermi előfizetést.

Kérésfejlécek

További információ: Partnerközpont – REST fejlécek. Az API válasza legfeljebb 300 oldalrekordot ad vissza. Ha egy bemeneti lekérdezés több mint 300 rekordot ad vissza, a válaszfejlécben egy folytatási jogkivonatot ad meg. A folytatási jogkivonat beírható a következő kérés fejlécébe, hogy további lekérdezett oldalrekordokat adjon vissza.

Kérés törzse

Nincs.

REST-válasz

Ha ez a módszer sikeres, a válasz törzsében migrált előfizetések (migrálási objektum) részleteit adja vissza. Ez magában foglalja a migrálási azonosítót.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Partnerközpont REST-hibakódjaiban találja.

Példák a kérelem URL-címére

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

Példák válaszra

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