İş Ortağı Merkezi REST API'lerini kullanarak yeni ticaret için aktarım oluşturma

İş ortakları yeni ticaret aboneliklerini bir işlem yapan iş ortağından diğerine aktarabilir. Aktarım isteğini bir hedef iş ortağı oluşturur. Kaynak iş ortağı satır öğesi ayrıntılarıyla aktarımı günceller. Bu konuda, bir hedef iş ortağının aktarım isteğini oluşturmak için çağıracağı API açıklanmaktadır. Bu konu yalnızca Azure Planı rezervasyonları, tasarruf planları, abonelikler ve yeni ticaret lisansı tabanlı abonelikler için geçerlidir. Daha fazla değerli bilgi abonelik aktarımı belgelerinde bulunabilir.

Önkoşullar

  • Kimlik bilgileri, İş Ortağı Merkezi kimlik doğrulaması kapsamında açıklandığı gibi. 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, İş Ortağı Merkezi'nde Müşteriler çalışma alanını, sonra müşteri listesinden müşteriyi ve ardından Hesap'ı seçerek bulabilirsiniz. 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.

  • Uygun roller: Yönetici aracısı

REST isteği

İstek söz dizimi

Metot İstek URI'si
PAYLAŞ {baseURL}/v1/customers/{customer-ID}/transfers HTTP/1.1

URI parametresi

Müşteriyi tanımlamak için aşağıdaki yol parametresini kullanın.

Adı Tür Zorunlu Açıklama
customer-id String Evet Müşteriyi tanımlayan GUID biçimli müşteri kimliği.

İstek başlıkları

Daha fazla bilgi için İş Ortağı Merkezi REST üst bilgileri kısmına bakın.

İstek gövdesi

Bu tabloda, yeni bir ticaret aktarım isteği oluşturmak için istek gövdesindeki TransferEntity özellikleri açıklanmaktadır.

Mülk Tür Zorunlu Açıklama
sourcePartnerTenantId String Evet Aktarımı başlatan iş ortağını tanımlayan, GUID formatında bir iş ortağı kimliği.
sourcePartnerName String Evet Aktarımı başlatan iş ortağının kuruluş adı.
müşteriEmailKimliği String Evet Aktarım oluşturma bildirimleri almak için müşteriye ait bir karakter dizisi.
müşteriAdı String Hayır isteğe bağlı. Abonelikleri aktarılmakta olan müşterinin adı.
targetPartnerTenantId String Hayır Aktarımın hedeflendiği iş ortağını tanımlayan GUID formatındaki iş ortağı kiracı kimliği. İş ortağı yetkilendirme bağlamı atlanırsa iş ortağı kiracı kimliğine çözümlenir.
hedefOrtakEmailId String Hayır Aktarımın hedeflendiği iş ortağını tanımlayan GUID formatındaki iş ortağı kiracı kimliği. İş ortağı yetkilendirme bağlamı atlanırsa iş ortağı kiracı kimliğine çözümlenir.
hedefÜrünTürleri String Hayır Aktarım için gönderilebilecek abonelik türlerini belirleyen dize koleksiyonu. Null tüm türler için varsayılan olarak kabul edilir. Değerler AzureSubscription, AzureReservation, AzureSavingsPlan ve OnlineServicesNCE olabilir.
partnerOnRecord String Hayır Aktarılan satır öğesi abonelikleri için kayıt iş ortağının MPNID'i. Yalnızca dolaylı sağlayıcı hedef iş ortaklarına geçiş yapıldığında geçerlidir.
transferTürü String Evet Aktarım türünü tanımlayan bir dize. 3, NewCommerce'i temsil eder ve Azure planı ve yeni ticaret lisans tabanlı abonelikler için kullanılmalıdır.

İstek örneği

{
    "id": "43fb1d3a-79fe-45a9-863e-9a4acf17b630",
    "status": "InProgress",
    "transferType": 3,
    "customerEmailId": "",
    "createdTime": "2024-04-30T18:31:41.5133355Z",
    "lastModifiedTime": "2024-05-01T00:51:55Z",
    "expirationTime": "2024-05-31T00:00:00Z",
    "customerName": "ipdbtrans2",
    "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "partnertenantid": "a94dcde1-ecd7-wace-a6ef-ef73ba6b8ba5",
    "sourcePartnerName": "Test_Test_IP4_AG",
    "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "targetPartnerName": "Test_Test_DB_AG",
    "targetPartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "partnerOnRecord": "456789",
    "targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
    "targetProductTypes": [
	    "AzureSubscription",
	    "AzureReservation",
	    "AzureSavingsPlan",
	    "OnlineServicesNCE“
	],
    "transferDirection": 2,
    "ignoreEligibilityCheck": false,
    "lastModifiedUser": "1671774b-679f-4543-a152-1f8b14006c0e",
    "lineItems": [{
        "id": 0,
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "billingCycle": "unknown",
        "quantity": 0,
        "productType": 5,
        "status": "InProgress"
    }],
    "links": {
        "self": {
            "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
            "method": "GET",
            "headers": []
        }
    }
}

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde doldurulmuş TransferEntity kaynağını 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 daha fazla hata ayıklama bilgisi ile birlikte gelir. Bu kodu, hata türünü ve diğer parametreleri okumak için bir ağ izleme aracı kullanın. Tam listeyi görmek için Hata Kodları'na bakın.

Dağıtımcılar aktarım oluştururken döndürülen bazı yaygın hatalar:

  • İş ortağı konum hesabı (PLA) yanlış: Dağıtımcıların aktarılan öğelere ayarlanmış kayıt ortağını bildirmesi gerekir. tr-TR: Geçersiz iş ortağı kimlikleri (Kimlikler) 900400 hata kodunu döndürür ve PLA Kimliği (eski adıyla MPN Kimliği) etkin bir bayi kiracısına bağlı değil..
  • Kiracı kimlikleri yanlış: Hatalı bir kaynak iş ortağı kiracı kimliği 900160 hata koduyla sonuçlanır ve "Aktarım isteği, mevcut iş ortağı Microsoft kimliği geçersiz veya etkin olmadığından başarısız oldu." şeklinde bir mesaj verir. Doğru Microsoft kimliğini almak için müşterinin geçerli iş ortağına başvurun. Yanlış müşteri kiracı kimliği, 20002 hatası ve mesajıyla sonuçlanır: Kaynak iş ortağının müşteri kiracı kimliği ile ticari ilişkisi yoktur.

Yanıt örneği

HTTP/1.1 201 Created
Content-Length: 138
Content-Type: application/json; charset=utf-8
MS-RequestId: 4fa6dad6-a89f-4875-8247-7294a10ae1cf
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US,en-US

{
"id": "43fb1d3a-79fe-45a9-863e-9a4acf17b630",
"status": "Pending",
"transferType": 3,
"customerEmailId": "",
"createdTime": "2024-04-30T18:31:41.5133355Z",
"lastModifiedTime": "2024-04-30T18:31:41Z",
"expirationTime": "2024-05-31T00:00:00Z",
"customerName": "ipdbtrans2",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"partnertenantid": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"sourcePartnerName": "Test_Test_IP4_AG",
"sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"targetPartnerName": "Test_Test_DB_AG",
"targetPartnerTenantId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"partnerOnRecord": "456789",
"targetProductTypes": [
    "AzureSubscription",
    "AzureReservation",
    "AzureSavingsPlan",
    "OnlineServicesNCE“
	],
"transferDirection": 1,
"ignoreEligibilityCheck": false,
"lastModifiedUser": "7ffdaa28-3b1c-4a61-b580-e1aa6ecf833c",
"links": {
    "self": {
        "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
        "method": "GET",
        "headers": []
    }
}
}
  • Last updated on