Yeni bir ticaret geçişi zamanlama

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

Uygun roller: Genel yönetici | Yönetici aracısı | Satış temsilcisi

Bu makalede Yeni Ticaret Deneyimi'nin nasıl zamanlandığı açıklanmaktadır.

Ö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.
Müşteri kimliği (customer-tenant-id). 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 (customer-tenant-id) aynıdır.
Geçerli abonelik kimliği

REST isteği

İstek söz dizimi

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

URI parametresi

Bu tabloda, yeni bir ticaret geçişi oluşturmak için gerekli sorgu parametreleri listelenir.

Ad	Tür	Zorunlu	Açıklama
customer-tenant-id	Dize	Evet	Müşteriyi tanımlayan GUID biçimli bir dize.

İstek üst bilgileri

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

Request body

Bu tabloda istek gövdesindeki abonelik özellikleri açıklanmaktadır.

Özellik	Tür	Zorunlu	Açıklama
currentSubscriptionId	Dize	Evet	Hangi aboneliğin geçiş için doğrulama gerektirdiğini gösteren abonelik tanımlayıcısı.
termDuration	Dize	Hayır	Geçiş sırasında değiştirilecek terim süresi belirtilebilir.
billingCycle	Dize	Hayır	Faturalama dönemi geçişte değiştirilecek şekilde belirtilebilir.
purchaseFullTerm	ikili	Hayır	Geçiş sırasında NCE'de yeni bir terim başlatılabilir.
miktar	int	No.	Geçiş sırasında abonelik için lisans miktarı artırılabilir veya azaltılabilir.
customTermEndDate	datetime	Hayır	Bitiş tarihi, mevcut bir deneme sürümü 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
targetDate	datetime	Gerekli (migrateOnRenewal null/false ise)	Geçişin zamanlanması gereken Hedef Tarih. targetDate belirtilen tarih için ayarlandıysa migrationOnRenewal null veya false olarak ayarlanabilir.
migrateOnRenewal	ikili	Gerekli (targetDate null ise)	migrateOnRenewal için bayrağı true olarak ayarlandıysa, geçişi zamanlamak için targetDate belirtmeye gerek yoktur.
addOnMigrationSchedules	ikili	Hayır	Zamanlanmış geçişe dahil edilecek AddOn aboneliklerinin listesini içerir.

İstek örneği

{
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde geçirilmekte olan aboneliklerin (geçiş nesnesi) ayrıntılarını döndürür.

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

Yanıt örnekleri

{
    "id": "f016c025-a873-47af-8b52-2516fbef4c65",
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

Aracılığıyla paylaş