Yeni ticaret geçişlerini sorgulama

Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

Geçirilen abonelikleri müşteri kimliğine, geçerli abonelik kimliğine veya dış başvuru kimliğine göre sorgulama

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

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

Bu API, iş ortağının seçtiği sorgu dizelerine göre filtreleyebilir. Seçili sorgu dizeleri aşağıdaki üç seçenek arasından biri olabilir:

• A CustomerTenantId. 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 aynıdır.

• CurrentSubscriptionId (geçirilen bir aboneliğin eski kimliği)

• ExternalReferenceId (Batch Geçiş Aracı tarafından döndürülen ve İş Ortağı Merkezi SDK'sı aracılığıyla indirilebilen toplu iş kimliği)

REST isteği

İstek söz dizimi

Metot	İstek URI'si
GET	{baseURL}/v1/migrations/newcommerce HTTP/1.1

Sorgu Dizeleri

Bu tabloda, yeni ticaret geçişlerini filtrelemek ve almak için gereken sorgu dizeleri listelenir. Geçişleri başarıyla sorgulamak için üç kimliklerden en az biri gereklidir. Sorguya birden çok kimlik girişi kabul edilir ancak gerekli değildir.

Veri Akışı Adı	Açıklama
CustomerTenantId	Müşteriyi tanımlayan GUID biçimli bir dize.
CurrentSubscriptionId	Geçirilen eski aboneliği tanımlayan GUID biçimli dize.
ExternalReferenceId	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. API'nin yanıtı en fazla 300 sayfa kaydı döndürür. Giriş yapılan sorguda 300'den fazla kayıt döndürülürse, yanıt üst bilgisinde bir devamlılık belirteci sağlanır. Devam belirteci sorgulanan ek sayfa kayıtlarını döndürmek için aşağıdaki isteğin üst bilgisine eklenebilir.

Request body

Yok.

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. Bu, geçiş kimliğini içerir.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu ve diğer 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ı.

İstek URL'si örnekleri

baseurl/v1/migrations/newcommerce?CustomerTenantId=83c51838-fed5-44a4-a275-afa201d53699&CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833&ExternalReferenceId=9ab61899-0b2b-4320-bd6d-8196c53607d6

baseurl/v1/migrations/newcommerce?CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833

Yanıt örnekleri

[
{
"addOnMigrations": [],
"id": "8ce7115e-0324-41b1-8ca3-7c7ae3b64f75",
"startedTime": "2022-02-24T23:50:30.4384819Z",
"completedTime": "2022-02-24T23:53:14.0813711Z",
"currentSubscriptionId": "9E289691-2FF3-419D-B39B-26B3E5A817FB",
"status": "Completed",
"customerTenantId": "ce6fcc21-c276-447b-9605-874decb9024b",
"catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
"newCommerceSubscriptionId": "f2d6534b-9e30-4cf5-c7b0-5d6393dbf12d",
"newCommerceOrderId": "09714c93092a",
"subscriptionEndDate": "2023-02-14T00:00:00Z",
"quantity": 2,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"externalReferenceId": "771317a4-275d-47d9-9724-3eefa4a168ad"
}
]