Yeni bir ticaret geçiş zamanlamasını güncelleştirme

Makale
10/26/2023

Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından sağlanan İş Ortağı Merkezi | Microsoft Cloud for US Government için İş Ortağı Merkezi

Bu makalede, yeni bir ticaret geçiş zamanlamasının nasıl güncelleştirildiği açıklanır. İş ortakları zamanlanan hedef tarihten önce güncelleştirilebilir.

Ö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 App+User kimlik bilgileriyle kimlik doğrulamayı destekler.
Müşteri kimliği (customer-tenant-id). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi'ndeMüşteriler çalışma alanını ve 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	Gerekli	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.

İstek gövdesi

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

Özellik	Tür	Gerekli	Açıklama
currentSubscriptionId	string	Yes	Hangi aboneliğin geçiş için doğrulama gerektirdiğini gösteren bir abonelik tanımlayıcısı. Güncelleştirme işlemi için izin verilmiyor.
termDuration	dize	No	Geçişte değiştirilecek terim süresi belirtilebilir.
billingCycle	dize	No	Faturalama dönemi geçişte değiştirilecek şekilde belirtilebilir.
purchaseFullTerm	bool	Hayır	Geçiş sırasında NCE'de yeni bir terim başlatılabilir.
miktar	int	Hayır	Abonelik için lisans miktarı geçiş sırasında 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	Hayır	Geçişin zamanlandığı hedef Tarih. targetDate belirtilen tarih için ayarlandıysa migrationOnRenewal null veya false olarak ayarlanabilir.
migrateOnRenewal	bool	Hayır	migrateOnRenewal için bayrağı true olarak ayarlandıysa, geçiş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ı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 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": "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"
}

Aracılığıyla paylaş