Yeni bir ticaret geçiş zamanlaması alma
Ş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 alındığı açıklanır.
Ö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
İş ortaklarının sorgulamak için kullanabileceği iki farklı yöntem vardır.
- Belirli bir zamanlamayı sorgulamak için
- Belirli bir ölçüt için zamanlama listesini alma
İstek söz dizimi
| Yöntem | İstek URI'si |
|---|---|
| GET | {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. |
| Yöntem | İstek URI'si |
|---|---|
| GET | {baseURL}/v1/migrations/newcommerce/schedules? CustomerTenantId={customer-tenant-id} |
URI parametresi
Bu tabloda, yeni bir ticaret geçişi oluşturmak için gerekli sorgu parametreleri listelenir. Sorgu parametresinden herhangi biri kullanılabilir.
| Ad | Tür | Açıklama |
|---|---|---|
| customerTenantId | string | Müşteriyi tanımlayan GUID biçimli bir dize. |
| currentSubscriptionID | string | Geçerli Abonelik Kimliğini tanımlayan GUID biçimli bir dize |
| externalReferenceID | string | Geçiş toplu işlemini tanımlayan GUID biçimli bir dize |
İstek üst bilgileri
Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.
Yanıt gövdesi
Bu tabloda yanıttaki abonelik özellikleri açıklanmaktadı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ı. |
| 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. |
| migrateOnRenewal | bool | Hayır | Zamanlamanın yenilemede gerçekleşmesi gerekip gerekmediğini gösterir |
| durum | dize | No | Zamanlama geçişinin durumu |
| createdTime | datetime | Hayır | Zamanlamanın oluşturulduğu zaman |
| lastModifiedTime | datetime | Hayır | Zamanlamanın en son ne zaman değiştirildiği |
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"
}
]