Yeni ticaret geçişi oluşturma
Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi
Aboneliğin Yeni Ticaret Deneyimi'ne geçişini oluşturma
Ön koş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
Hız sınırı
Geçiş API'sini Oluştur sınırı, bir iş ortağı tarafından 5 dakikada yapılan 100 çağrıdır. Hız sınırları ve azaltma hakkında daha fazla bilgiyi API azaltma kılavuzunda bulabilirsiniz.
REST isteği
İstek söz dizimi
Yöntem | İstek URI'si |
---|---|
POST | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce HTTP/1.1 |
URI parametresi
Bu tabloda, yeni bir ticaret geçişi oluşturmak için gerekli sorgu parametreleri listelenir.
Ad | Tür | Zorunlu | Tanım |
---|---|---|---|
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 | Tanım |
---|---|---|---|
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 terim süresi değiştirilebilir. |
billingCycle | Dize | Hayır | Geçiş sırasında faturalama döngüsü değiştirilebilir. |
purchaseFullTerm | ikili | Hayır | Geçiş sırasında NCE'de yeni bir terim başlatılabilir. |
quantity | int | Hayır | Geçiş sırasında abonelik için lisans miktarı artırılabilir veya azaltılabilir. |
customTermEndDate | datetime | Hayır | Bitiş tarihi, mevcut bir çevrimiçi 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 örneği
Not: İç içe eklentiler (eklenti abonelikleri olan eklenti abonelikleri), addOnMigrations içinde düz bir liste olarak istek gövdesine yazılmalıdır ve istekteki diğer eklenti aboneliklerinin içine yerleştirilmemelidir; Eklentilerin istek gövdesinde nasıl yazılacağına ilişkin son istek örneğine bakın.
{
"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"
}
{
"currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC",
"termDuration": "P1M",
"billingCycle": "Monthly",
}
{
"currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC",
"purchaseFullTerm": true
}
{
"currentSubscriptionId": "66E738D6-E0BC-4FFB-8818-BDE99BC7008B",
"quantity": 1,
"billingCycle": "Annual",
"purchaseFullTerm": false,
"termDuration": "P1Y",
"addOnMigrations": [
{
"currentSubscriptionId": "359011DC-B5B0-4660-850B-A8FA9B2E3309",
"quantity": 1,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1M"
},
{
"currentSubscriptionId": "159D9F87-CE39-4EBD-B9C2-ECF0892A85A1",
"quantity": 1,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1Y"
}
]
}
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.
Yanıt başarısı ve hata kodları
Her yanıt, başarılı veya başarısız olduğunu 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
{
"addOnMigrations": [
{
"currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
"customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
"catalogItemId": "CFQ7TTC0LH0T:0001:CFQ7TTC0K4KQ",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
},
{
"currentSubscriptionId": "80906BD9-E45C-4D1B-92A8-EA3F3FB6E105",
"customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
"catalogItemId": "CFQ7TTC0LH0R:0001:CFQ7TTC0K0SK",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
},
{
"currentSubscriptionId": "72E424F4-10FF-4C76-B101-C274F73BA498",
"customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
"catalogItemId": "CFQ7TTC0LHXJ:0001:CFQ7TTC0KHTR",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
}
],
"id": "7123c075-fc05-42d6-a21e-1d2036fa490b",
"startedTime": "2022-02-23T13:00:48.4489832Z",
"currentSubscriptionId": "2E56C7F5-E120-4CA4-BFF3-7DA763B4D777",
"status": "Processing",
"customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
"catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
}
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin