Yeni ticaret aboneliğine geçiş

  • Makale
  • Okumak için 4 dakika

Uygulama hedefi: Iş Ortağı Merkezi | 21Vianet tarafından işletilen iş ortağı Merkezi | Microsoft Bulut Almanya için iş ortağı Merkezi | Microsoft Cloud for US Government için iş ortağı Merkezi

Uygun roller

  • Genel yönetici
  • Yönetim Aracısı

Not

Yeni ticaret değişiklikleri şu anda yalnızca M365/D365 yeni ticaret deneyimi teknik önizlemesinin parçası olan iş ortakları tarafından kullanılabilir.

Müşterinin yeni ticari aboneliğini hedef aboneliğe yükseltmek için kullanılır. Aboneliklerin geçişini yapmak için iki API isteğinin yapılması gerekir. İlk olarak, SKU 'Ları yükseltme için kullanılabilir hale getirmek için uygun geçişleri alın . Sonra geçişi yürütmek için geçiş sonrası . Bu yöntemler hem geleneksel hem de yeni ticaret kaynağı aboneliklerini destekler.

Geçiş elizlikler al

Belirli bir müşteri, abonelik ve istenen tür için uygun geçişlerin listesini döndürür.

Önkoşullar

  • Iş ortağı merkezi kimlik doğrulamasındaaçıklandığı gibi kimlik bilgileri. Bu senaryo, hem tek başına uygulama hem de uygulama + kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

  • Bir müşteri KIMLIĞI ( customer-tenant-id ). Müşterinin KIMLIĞINI bilmiyorsanız Iş Ortağı Merkezi panosundabulabilirsiniz. Iş Ortağı Merkezi menüsünden CSP ' yi ve ardından müşteriler' i seçin. Müşteri listesinden müşteriyi seçin ve ardından Hesap' ı seçin. 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ĞI () ile aynıdır customer-tenant-id .

  • İlk abonelik için bir abonelik KIMLIĞI.

REST isteği

İstek sözdizimi

Yöntem İstek URI'si
AL {BaseUrl}/v1/Customers/{Customer-Tenant-id}/Subscriptions/{Subscription-id}/geçişli tioneligılıklara? eligibilityType = {ım, ZAMANLANDı} http/1.1

URI parametresi

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

Ad Tür Gerekli Açıklama
Müşteri-Kiracı kimliği guid Y Müşterinin kiracısına karşılık gelen bir GUID.
abonelik kimliği guid Y İlk aboneliğe karşılık gelen bir GUID.
eligibilityType string N Geçişin ne zaman yürütüleceğini açıklar; anında veya zamanlanmış olabilir. Immediate varsayılan değerdir.

İstek üst bilgileri

Daha fazla bilgi için bkz. Iş ortağı MERKEZI Rest üstbilgileri.

İstek gövdesi

Hiçbiri

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitionEligibilities?eligibilityType=immediate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde verilen abonelik için uygun geçişlerin listesini döndürür.

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

Her yanıt başarı veya başarısızlık ve ek hata ayıklama bilgilerini gösteren bir HTTP durum kodu ile gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. hata kodları.

Uygunluk hataları

Hata açıklamaları ve anlamı.

Hata açıklaması Anlamı
Abonelik geçirilemez-kaynak abonelik etkin değil. Özgün alt durum etkin değil
Abonelik geçirilemez-kaynak abonelik henüz sağlanmadı. Özgün Sub FulfillmentState başarılı değil
Geçiş türü uyumlu değil-AzureAD abonelik eşlemesi gerekiyor. GetSubscriptionUpgradeConflicts çağrılırken Legacycannotconvertsubscriptionıd hatası
Geçiş türü uyumlu değil-lisans aktarımı için çakışan abonelikler var. herhangi bir AAD hizmeti farklı bir abonelikteki abonelik kimliklerine sahipse, bunu çakışma listesine ekleyin (eski veya modern satın alma akışından yapılan satınalmaları içerir)

Yanıt örneği

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "totalCount": 2,
    "items": [
        {
            "catalogItemId": "CFQ7TTC0KZCR:0001:CFQ7TTC0K71H",
            "title": "Microsoft 365 E5 Test Sku Title",
            "description": "Microsoft 365 E5 Test Sku Description",
            "quantity": 1,
            "eligibilities": [
{
                    "isEligible": true,
                    "transitionType": "transition_only",
                    "errors": []
                },
                
{
                    "isEligible": false,
                    "transitionType": "transition_with_license_transfer",
                    "errors": [
                        {
                            "code": 3,
                            "description": "Subscription cannot be transitioned because there are conflicting services."
                        }
                    ]
                }
            ],
            "attributes": {
                "objectType": "TransitionEligibility"
            }
        },
        {
            "catalogItemId": "CFQ7TTC0L4M3:0001:CFQ7TTC0K78T",
            "title": "Business Premium Test Sku Title",
            "description": "Business Premium Test Sku Description",
            "quantity": 1,
            "eligibilities": [
                {
                    "isEligible": false,
                    "transitionType": "transition_with_license_transfer",
                    "errors": [
                        {
                            "code": 3,
                            "description": "Subscription cannot be transitioned because there are conflicting services."
                        }
                    ]
                }
            ],
            "attributes": {
                "objectType": "TransitionEligibility"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

Geçiş sonrası

Belirli bir müşteri ve abonelik için bir geçiş isteği gönderir. Geçişi başlangıç durumuyla birlikte döndürür.

Önkoşullar

  • Iş ortağı merkezi kimlik doğrulamasındaaçıklandığı gibi kimlik bilgileri. Bu senaryo, hem tek başına uygulama hem de uygulama + kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

  • Bir müşteri KIMLIĞI ( customer-tenant-id ). Müşterinin KIMLIĞINI bilmiyorsanız Iş Ortağı Merkezi panosundabulabilirsiniz. Iş Ortağı Merkezi menüsünden CSP ' yi ve ardından müşteriler' i seçin. Müşteri listesinden müşteriyi seçin ve ardından Hesap' ı seçin. 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ĞI () ile aynıdır customer-tenant-id .

  • İlk abonelik için bir abonelik KIMLIĞI.

REST isteği

İstek sözdizimi

Yöntem İstek URI'si
YAYINLA {BaseUrl}/v1/Customers/{Customer-Tenant-ID}/Subscriptions/{Subscription-id}/geçişleri http/1.1

URI parametresi

Bir geçişi yürütmek için aşağıdaki sorgu parametrelerini kullanın.

Ad Tür Gerekli Açıklama
customer-tenant-id guid Y Müşterinin kiracısına karşılık gelen GUID.
subscription-id guid Y İlk aboneliğe karşılık gelen GUID.

İstek üst bilgileri

Daha fazla bilgi için bkz. İş Ortağı Merkezi REST üst bilgileri.

İstek gövdesi

Bu tabloda, istek gövdesinin Geçiş özellikleri açık edilmektedir.

Özellik Tür Gerekli Açıklama
fromCatalogItemId dize No Geçişte olduğunu katalog öğesi.
fromSubscriptionId dize No Geçişte olduğunu abonelik kimliği.
toCatalogItemId string Yes Geçişte olduğunu katalog öğesi.
toSubscriptionId dize No Geçişte olduğunu abonelik kimliği.
miktar tamsayı Yes Geçiş için gereken lisans sayısı.
termDuration dize No Aboneliğin süre süresini belirtme.
billingCycle dize No Aboneliğin faturalama döngüsünü belirtme.
transitionType string Yes Geçiş türü. Olası değerler - transition_only , transition_with_license_transfer .

İstek örneği

POST https://api.partnercenter.microsoft.com/v1/customers/{customerId}/subscriptions/{subscriptionId}/transitions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US

{
    "fromCatalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0K39X",
    "fromSubscriptionId": "e487e8dc-421e-4275-cb42-3c1c8daccf70",
    "toCatalogItemId": "CFQ7TTC0LF8R:0001:CFQ7TTC0KCSV",
    "toSubscriptionId": "0af52192-4a2a-4364-d25b-c8ecab3a5697",
    "quantity": 2,
    "termDuration": "P1M",
    "billingCycle": "Monthly",
    "transitionType": "transition_only"
}

REST yanıtı

Başarılı olursa, bu yöntem ilk durumuna sahip bir Geçiş kaynağı döndürür.

Yanıt başarı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu gösteren 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 liste için bkz. Hata Kodları.

Yanıt örneği

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "fromCatalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0K39X",
    "fromSubscriptionId": "e487e8dc-421e-4275-cb42-3c1c8daccf70",
    "toCatalogItemId": "CFQ7TTC0LF8R:0001:CFQ7TTC0KCSV",
    "toSubscriptionId": "0af52192-4a2a-4364-d25b-c8ecab3a5697",
    "quantity": 2,
    "termDuration": "P1M",
    "billingCycle": "Monthly",
    "transitionType": "transition_only"
    "Events": [
        {
            "name": "Conversion",
            "status": "Started ",
            "timestamp": "2021-01-08T18:01:14.7488618Z",
            "attributes":
            {
                "objectType": "TransitionEvent"
            }
        }
    ],
    "attributes":
    {
        "objectType": "Transition" 
    }
}