Geçişleri alma

Makale
03/07/2025

Şunun için geçerlidir:

İş Ortağı Merkezi

Uygun roller

Yönetici Temsilcisi

Not

Lisans tabanlı hizmetler için yeni ticaret deneyimleri birçok yeni özellik içerir ve tüm Bulut Çözümü Sağlayıcısı (CSP' ler) tarafından kullanılabilir. Daha fazla bilgi için yeni ticaret deneyimlerine genel bakış bölümüne bakın.

Belirli bir müşteri ve abonelik için geçişlerin geçmişini almak için kullanılır. Geçmiş, geçiş için işlenen tüm olayları içerir. Bu yalnızca yeni ticari lisans tabanlı abonelik geçişlerini destekler.

Önkoşullar

Partner 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). Eğer müşterinin kimliğini bilmiyorsanız, Partner Merkezi'nde Müşteriler çalışma alanını, ardından müşteri listesinden seçtiğiniz müşteriyi ve sonra Hesap'ı seçerek arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümü altında Microsoft Kimliği'ni arayın. Microsoft Kimliği, müşteri kimliğiyle (customer-tenant-id) aynıdır.
Geçiş yapılan abonelik için bir abonelik kimliği.

REST isteği

[GET] customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions

İstek söz dizimi

Metot	İstek URI'si
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1

URI parametresi

Uygun geçişleri döndürmek için aşağıdaki sorgu parametrelerini kullanın.

Adı	Tür	Zorunlu	Açıklama
müşteri-kiracı-kimliği	guid	Y	Müşterinin kiracısına karşılık gelen GUID.
abonelik-id	Kılavuz	Y	İlk aboneliğe karşılık gelen GUID.
operation-id	guid	N	Bir Geçişi benzersiz olarak tanımlamak ve durumunu izlemek için bir GUID.

İstek başlıkları

Daha fazla bilgi için, Ortak Merkezi REST başlıklarına bakın.

İstek gövdesi

Hiçbiri

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

REST yanıtı

Başarılı olursa, belirtilen abonelik için değişikliklerin geçmişini 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 belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam listeyi görmek için bkz: Hata Kodları.

Yanıt örneği

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "transition": [
        {
        "operationId": "1caf8ec7-62cc-4ab5-b35d-572d2a62974c", 
        "FromCatalogItemId": "CFQ7TTC0LDPB:0001:CFQ7TTC0LGNT",
        "ToCatalogItemId": "CFQ7TTC0LF8S:0001:CFQ7TTC0K9G9",
        "quantity": 1,
        "transitionType": "transition_with_license_transfer",
        "Events": [
           {
               "name": "Conversion",
               "status": "Started ",
               "timestamp": "2021-01-08T18:01:14.7488618Z",
               "attributes":
                     {
                          "objectType": "TransitionEvent"
                     }
           }, 
           {
               "name": "Conversion",
               "status": "Completed",
               "timestamp": "2021-01-08T18:37:41.591855Z",
               "attributes":
                     {
                          "objectType": "TransitionEvent"
                     }
            }
        ],
        "attributes":
               {
                     "objectType": "Transition"
               }
        }
    ],
    "attributes":
        {
               "objectType": "Collection"
        }
}

Aracılığıyla paylaş