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

Makale
09/20/2024

İş 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ğı aktarımı satır öğesi ayrıntılarıyla güncelleştirir. 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 değerli bilgiler abonelik aktarımı belgelerinde bulunabilir.

Ö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.
Müşteri kimliği (customer-tenant-ID). 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 (customer-tenant-ID) aynıdır.
Uygun roller: Yönetici aracısı

REST isteği

İstek söz dizimi

Metot	İstek URI'si
POST	{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	Yes	Müşteriyi tanımlayan GUID biçimli müşteri kimliği.

İstek üst bilgileri

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

Request body

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

Özellik	Type	Zorunlu	Açıklama
sourcePartnerTenantId	string	Yes	Aktarımı başlatan iş ortağını tanımlayan GUID biçimli iş ortağı kimliği.
sourcePartnerName	string	Yes	Aktarımı başlatan iş ortağının kuruluş adı.
customerEmailId	string	Yes	Aktarım oluşturma bildirimleri almak için müşterinin dizesi.
customerName	Dize	Hayır	isteğe bağlı. Abonelikleri aktarılmakta olan müşterinin adı.
targetPartnerTenantId	Dize	Hayır	Aktarımın hedeflendiği iş ortağını tanımlayan GUID biçimli iş ortağı kiracı kimliği. İş ortağı yetkilendirme bağlamı atlanırsa iş ortağı kiracı kimliğine çözümlenir.
targetPartnerEmailId	Dize	Hayır	Aktarımın hedeflendiği iş ortağını tanımlayan GUID biçimli iş ortağı kiracı kimliği. İş ortağı yetkilendirme bağlamı atlanırsa iş ortağı kiracı kimliğine çözümlenir.
transferType	string	Yes	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": "a624f7f8-408b-49d0-9320-df79e56bed55",
    "partnertenantid": "a94dcde1-ecd7-wace-a6ef-ef73ba6b8ba5",
    "sourcePartnerName": "Test_Test_IP4_AG",
    "sourcePartnerTenantId": "a94dcde1-ecd7-4ace-a6ef-ef73ba6b8ba5",
    "targetPartnerName": "Test_Test_DB_AG",
    "targetPartnerTenantId": "817512dd-0689-47a0-bbf2-a7f11ae1fc11",
    "targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
    "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/a624f7f8-408b-49d0-9320-df79e56bed55/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
            "method": "GET",
            "headers": []
        }
    }
}

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde doldurulan TransferEnity 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 liste için bkz . Hata Kodları.

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": "a624f7f8-408b-49d0-9320-df79e56bed55",
"partnertenantid": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"sourcePartnerName": "Test_Test_IP4_AG",
"sourcePartnerTenantId": "a94dcde1-ecd7-4ace-a6ef-ef73ba6b8ba5",
"targetPartnerName": "Test_Test_DB_AG",
"targetPartnerTenantId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"transferDirection": 1,
"ignoreEligibilityCheck": false,
"lastModifiedUser": "7ffdaa28-3b1c-4a61-b580-e1aa6ecf833c",
"links": {
    "self": {
        "uri": "/customers/a624f7f8-408b-49d0-9320-df79e56bed55/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
        "method": "GET",
        "headers": []
    }
}
}

Aracılığıyla paylaş