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

發行項
09/20/2024

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

必要條件

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

REST 要求

要求語法

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

URI 參數

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

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

要求標頭

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

要求本文

下表描述建立新商務轉移要求的要求本文中的 TransferEntity 屬性。

屬性	型別	必要	描述
sourcePartnerTenantId	字串	Yes	GUID 格式化的合作夥伴識別碼，可識別起始傳輸的夥伴。
sourcePartnerName	字串	Yes	正在起始轉移之合作夥伴組織的名稱。
customerEmailId	字串	Yes	要接收傳輸建立通知的客戶字串。
customerName	字串	No	選擇性。要轉移其訂閱的客戶名稱。
targetPartnerTenantId	字串	No	GUID 格式化的合作夥伴租使用者標識碼，可識別轉移的目標合作夥伴。如果省略合作夥伴授權內容，則解析為合作夥伴租使用者標識符。
targetPartnerEmailId	字串	No	GUID 格式化的合作夥伴租使用者標識碼，可識別轉移的目標合作夥伴。如果省略合作夥伴授權內容，則解析為合作夥伴租使用者標識符。
transferType	字串	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",
    "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",
"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": []
    }
}
}

共用方式為