Yeni bir ticaret geçiş zamanlamasını güncelleştirme
Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi
Bu makalede yeni bir ticaret geçiş zamanlamasının nasıl güncelleştirildiği açıklanmaktadır. İş ortakları zamanlanan hedef tarihten önce güncelleştirebilir.
Önemli
Bu API şu anda yalnızca Korumalı Alan kiracısında kullanılabilir.
Ö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 |
|---|---|
| PUT | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID} |
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 | string | Yes | Müşteriyi tanımlayan GUID biçimli bir dize. |
| scheduleID | string | Yes | Zamanlamayı 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 | string | Yes | Hangi aboneliğin geçiş için doğrulama gerektirdiğini gösteren abonelik tanımlayıcısı. Güncelleştirme işlemi için izin verilmiyor. |
| termDuration | Dize | Hayır | Geçiş için terim süresi. |
| billingCycle | Dize | Hayır | Geçiş için faturalama döngüsü. |
| purchaseFullTerm | ikili | Hayır | Geçişin geçerli eski terime devam edip etmediği veya yeni bir terim başlatıp başlatmadığı. |
| 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 |
| targetDate | datetime | Hayır | Geçişin zamanlanması gereken Hedef Tarih. targetDate belirtilen tarih için ayarlandıysa migrationOnRenewal null veya false olarak ayarlanabilir. |
| migrateOnRenewal | ikili | Hayır | migrateOnRenewal için bayrağı true olarak ayarlandıysa, geçiş zamanlamak için targetDate değerinin belirli olması gerekmez. |
İstek örneği
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00"
}
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 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
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00",
"createdTime": "2022-10-18T21:20:50.9668605+00:00",
"lastModifiedTime": "2022-10-18T21:29:32.8992819+00:00"
}