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

Cikk
03/09/2025

Aa következőkre vonatkozik: Partnerközpont | 21Vianet által üzemeltetett Partnerközpont | Partnerközpont az amerikai kormányzat számára fenntartott Microsoft Cloudhoz

A partnerek megtekinthetik az ügyfelek számára vásárolt NCE licencalapú előfizetések engedélyezett egyéni időszakzáró dátumait. 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

Az Partnerközpont hitelesítéseleírásában szereplő hitelesítő adatok. 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 ÜgyfélBérlőKód. Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban a Ügyfelek munkaterület kiválasztásával, majd az ügyfél kiválasztásával az ügyféllistából, végül a Fiókkiválasztásával. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosí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

Módszer	URI kérése
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:
időtartam	Igen	A kifejezés időtartamának ISO 8601-es ábrázolása. A jelenlegi támogatott értékek P1M (1 hónap), P1Y (1 év) és P3Y (3 év).
időszak kezdési dátuma	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érelemfejlécek

További információ: Partnerközpont REST-fejlécei. 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 token beírható a következő kérés fejlécébe, hogy további oldalrekordokat adjon vissza a lekérdezéshez.

Kérelem tartalma

Egyik sem.

REST-válasz

Ha sikeres, ez a módszer a válasz törzsében a migrált előfizetések 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 lásd a(z) Partnerközpont REST hibakódjai.

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

Megosztás a következőn keresztül: