Özel terim bitiş tarihlerini alma

Makale
02/19/2024

Şunlar 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

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

REST isteği

İstek söz dizimi

Metot	İ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:
term_duration	Yes	Terimin süresinin ISO 8601 gösterimi. Desteklenen geçerli değerler P1M (1 ay), P1Y (1 yıl) ve P3Y (3 yıl) değerleridir.
term_start_date	Hayır	Hedeflenen satın alma tarihi. Bu geçmişte olamaz.
target_coterm_subscription_id	Hayır	Coterm için aboneliği tanımlayan GUID biçimli bir dize.

İstek üst bilgileri

Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri. 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.

Request body

Yok.

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde geçirilen Aboneliklerin (geçiş nesnesi) 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ş