使用合作夥伴中心 REST API 為新商務建立轉移

發行項
03/07/2025

合作夥伴可以將新的商務訂閱從一個交易夥伴轉移到另一個交易夥伴。目標合作夥伴創建移轉請求。來源合作夥伴會使用明細專案詳細數據來更新傳輸。本主題說明目標合作夥伴呼叫以建立傳輸要求的 API。本主題僅適用於 Azure 方案保留、節省方案和訂用帳戶，以及新的商務授權型訂用帳戶。更有價值的資訊可以在訂閱轉移文檔中找到。

必要條件

認證如「合作夥伴中心驗證」中所述。此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
客戶識別碼 (customer-tenant-ID)。如果您不知道客戶的 ID，您可以在合作夥伴中心中透過選取客戶工作區，然後從客戶清單中選擇客戶，再前往帳戶來查詢。在客戶的 [帳戶] 頁面上，尋找 [客戶帳戶資訊] 區段中的 [Microsoft 識別碼]。 Microsoft 識別碼與客戶識別碼 (customer-tenant-ID) 相同。
適當的角色：管理員代理

REST 要求

求語法

方法	要求 URI
POST	{baseURL}/v1/customers/{customer-ID}/transfers HTTP/1.1

URI 參數

使用下列路徑參數來識別客戶。

名稱	類型	必要	描述
customer-id	字串	Yes	識別客戶的 GUID 格式客戶識別碼。

請求標頭

如需更多資訊，請參閱合作夥伴中心 REST 標頭。

請求主體

下表描述了在請求主體中，用於建立新商務轉移請求的屬性。

財產	類型	必要	描述
sourcePartnerTenantId (來源合作夥伴租戶ID)	字串	Yes	GUID 格式化的合作夥伴識別碼，可識別起始傳輸的夥伴。
sourcePartnerName	字串	Yes	正在起始轉移之合作夥伴組織的名稱。
客戶郵件ID	字串	Yes	接收轉帳建立通知的客戶資訊字串。
客戶名稱	字串	不	選擇性。要轉移其訂閱的客戶名稱。
targetPartnerTenantId	字串	不	GUID 格式化的合作夥伴租用戶 ID，用於識別轉移目標的合作夥伴。如果省略合作夥伴授權上下文，則會解析為合作夥伴租戶 ID。
目標合作夥伴電子郵件識別碼	字串	不	GUID 格式的合作夥伴租戶 ID，用於識別轉移目標的合作夥伴。如果省略合作夥伴授權上下文，則解析成合作夥伴租戶 ID。
目標產品類型	字串	不	字串集合，指定可提交以進行轉移的訂用帳戶類型。 Null 被視為所有類型的預設值。值可以包含 AzureSubscription、AzureReservation、AzureSavingsPlan 和 OnlineServicesNCE。
傳輸類型	字串	Yes	定義傳輸類型的字串。 3 代表 New Commerce ，應該用於 Azure 方案和新的商務授權型訂用帳戶。

要求範例

{
    "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",
    "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 回應

如果成功，此方法會在響應主體中返回已填充的 TransferEnity 資源。

回應成功和錯誤碼

每個回應都有一個 HTTP 狀態代碼，指出成功或失敗，以及更多偵錯資訊。使用網路追蹤工具來讀取此程式代碼、錯誤類型等等參數。如需完整清單，請參閱錯誤代碼。

回應範例

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",
"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": []
    }
}
}

共用方式為