Özel terim bitiş tarihlerini alma

Makale
07/25/2023

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

Ö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

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. Sorguya birden çok kimlik girişi kabul edilir ancak gerekli değildir.

Adı	Zorunlu	Description
TermDuration	Evet	Müşteriyi tanımlayan GUID biçimli bir dize.
TermStartDate	Hayır	Geçirilen eski aboneliği tanımlayan GUID biçimli dize.
TargetCotermSubscriptionId	Hayır	Geçiş toplu işlemini 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"
    }
 }