Geçiş için aboneliği doğrulama

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

Yeni Ticaret Deneyimi'ne geçiş için aboneliği doğrulama

Önkoşullar

• İş Ortağı Merkezi kimlik doğrulaması'nde açıklandığı gibi kimlik bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

• Bir müşteri kimliği (customer-tenant-id). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi içinde Müşteriler çalışma alanını seçip, müşteri listesinden müşteriyi, ardından da Hesapseçeneğini seçerek arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Kimliği'ni bulun. Microsoft kimliği, müşteri kimliğiyle (customer-tenant-id) aynıdır.

• Geçerli abonelik kimliği

Hız sınırı

Geçişi Doğrulama API'si sınırı, 5 dakika içinde iş ortağı-müşteri kombinasyonu başına 450 çağrıdır. Oran sınırları ve sınırlama hakkında daha fazla bilgi için API sınırlama kılavuzu.

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/validate HTTP/1.1

URI parametresi

Bu tabloda, geçişin aboneliğini doğrulamak için gerekli sorgu parametreleri listelenir.

Ad	Tür	Gerekli	Açıklama
müşteri-kiracı-kimliği	string	Evet	Müşteriyi tanımlayan GUID biçimli bir dize.
süreDönemi	dizgi	Hayır	Geçiş sırasında dönem süresi değiştirilebilir.
billingCycle	dizgi	Hayır	Geçiş sırasında faturalama döngüsü değiştirilebilir.
tam dönem satın alma	Bool	Hayır	Geçişle birlikte NCE'de yeni bir dönem başlatılabilir.
miktar	Int	Hayır	Geçiş sırasında abonelik için lisans miktarı artırılabilir veya azaltılabilir.
özelDönemBitişTarihi	tarih ve saat	Hayır	Bitiş tarihi, mevcut bir deneme olmayan OnlineServicesNCE aboneliği veya takvim ayıyla uyumlu olacak şekilde ayarlanabilir. Burada abonelik bitiş tarihlerini hizalama hakkında daha fazla bilgi bulabilirsiniz: İş Ortağı Merkezi'nde abonelik bitiş tarihlerini hizalama

İstek başlıkları

Daha fazla bilgi için bkz. İş Ortağı Merkezi REST üst bilgileri.

İstek gövdesi

Bu tablodaki Abonelik özellikleri, istek gövdesinde açıklanmaktadır.

Mülk	Tür	Gerekli	Açıklama
mevcutAbonelikId	dizgi	Evet	Hangi aboneliğin geçiş için doğrulama gerektirdiğini gösteren abonelik tanımlayıcısı.

İstek örneği

"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde mevcut aboneliğin yeni ticarete geçiş için uygun olup olmadığını belirten bir "isEligible" boolean değeri döndürür. Geçişi Doğrulama API'sinin, aboneliğin Yeni Ticaret'teki promosyonlara uygunluğuyla ilgili bilgi sağlamadığını unutmayın.

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

Her yanıt, başarıyı veya başarısızlığı ve ek hata ayıklama bilgilerini gösteren bir HTTP durum koduyla birlikte gelir. Bu kodu, hata türünü ve diğer parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. İş Ortağı Merkezi REST hata kodları.

Yanıt örnekleri

1. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": false,
        "errors": [
            {
                "code": 5,
                "description": "Subscription cannot be migrated to New Commerce because the equivalent offer is not yet available in New Commerce",
            }
        ]
    }

2. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": true,
        "catalogItemId": "CFQ7TTC0LF8S:0002:CFQ7TTC0KSVV"
    }