Özel terim bitiş tarihlerini alma

Makale
08.03.2025

için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

İş ortakları, müşterileri için satın aldıkları NCE lisans tabanlı abonelikler için izin verilen özel dönem bitiş tarihlerini görüntüleyebilir. İş ortakları, takvim ayının sonuyla veya mevcut müşteri abonelikleriyle aynı dönemle uyumlu bitiş tarihlerini görüntüleyebilir.

API'ler, mevcut aboneliklerin yenilenmesi için değil, yalnızca yeni aboneliklerin satın alınması için özel dönem bitiş tarihlerinin hesaplanması için destek sağlar.

Önkoşullar

Kimlik bilgileri, İş Ortağı Merkezi kimlik doğrulaması'nde açıklandığı gibi. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.
Bir MüşteriKiracıId. Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi'nde Müşteriler çalışma alanını, ardından müşteri listesinden müşteriyi ve son olarak Hesapseçeneğini seçerek arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Kimliği arayın. Microsoft Kimliği, müşteri kimliğiyle aynıdır.

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
get	{baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates

Sorgu Dizeleri

Bu tabloda, özel terim bitiş tarihlerini filtrelemek ve almak için gereken sorgu dizeleri listelenir.

Ad:	Gerekli:	Açıklama:
dönem süresi	Evet	Terimin süresinin ISO 8601 gösterimi. Desteklenen geçerli değerler P1M (1 ay), P1Y (1 yıl) ve P3Y (3 yıl).
dönem başlangıç tarihi	Hayır	Hedeflenen satın alma tarihi. Bu geçmişte olamaz.
target_coterm_subscription_id	Hayır	Coterm ile abone olmayı tanımlayan GUID biçimli bir dize.

İstek başlıkları

Daha fazla bilgi için bkz. İş Ortağı Merkezi REST başlıkları. API'nin yanıtı en fazla 300 sayfa kaydı döndürür. Giriş yapılan sorguda 300'den fazla kayıt döndürülürse, yanıt üst bilgisinde bir devamlılık belirteci sağlanır. Devam belirteci sorgulanan ek sayfa kayıtlarını döndürmek için aşağıdaki isteğin üst bilgisine eklenebilir.

İstek gövdesi

Hiç kimse.

REST yanıtı

Başarılı olursa, bu yöntem, yanıt gövdesinde, (geçiş nesnesi) taşınan Abonelikleri ayrıntılarını döndürür. Bu, geçiş kimliğini içerir.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. İş Ortağı Merkezi REST hata kodları.

İstek URL'si örnekleri

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

Yanıt örnekleri

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

Aracılığıyla paylaş