取得新的商務遷移活動

發行項
03/07/2025

適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府Microsoft雲端合作夥伴中心

如何根據目前的訂用帳戶標識碼或移轉標識碼取得移轉事件的詳細數據

先決條件

合作夥伴中心驗證中所述的認證。此案例支援使用獨立應用程式和 App+使用者認證進行驗證。

此 API 可以根據合作夥伴選取的查詢字串來取得移轉事件。選取的查詢字串可以包含下列選項：

CustomerTenantId（客戶租戶ID）如果您不知道客戶的標識碼，您可以在合作夥伴中心中查閱，先選擇 [客戶工作區]，然後從客戶清單中選取客戶，最後選擇帳戶。在客戶的 [帳戶] 頁面上，在 [客戶帳戶資訊] 區段中尋找 Microsoft 帳戶識別碼。 Microsoft標識碼與客戶標識符相同。
CurrentSubscriptionId（已移轉之訂用帳戶的之前識別碼）
MigrationId （與目前訂用帳戶相關聯的移轉物件標識碼）

REST 要求

要求語法

方法	要求 URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/events HTTP/1.1

查詢字串

下表列出可用來擷取新商務移轉事件的查詢字串。至少需要提供兩個標識符中的一個，才能成功擷取與目前訂用帳戶相關聯的移轉事件。輸入移轉標識碼和當前訂閱帳戶標識碼是可以接受的，但不是必須的。

名字	描述
MigrationId	識別移轉物件的 GUID 格式字串。
CurrentSubscriptionId	GUID 格式的字串，可識別已移轉的舊版訂用帳戶。

請求標頭

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

請求主體

沒有。

REST 回應

如果成功，此方法將在回應內文中傳回已移轉之目前訂閱的事件詳細資訊。

回應成功和錯誤碼

每個回應都有一個 HTTP 狀態代碼，指出成功或失敗和其他偵錯資訊。使用網路追蹤工具來讀取此程式代碼、錯誤類型和其他參數。如需完整清單，請參閱合作夥伴中心 REST 錯誤碼。

請求 URL 範例

baseurl/v1/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/migrations/newcommerce/events?current_subscription_id=02DF825B-D0C9-40BE-8CB6-BAC895510D0A

回應範例

[
    {
        "id": "6eb07675-ba1d-45c2-9d05-c693a4863427",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "createdTime": "2022-06-11T00:06:02.7529574Z",
        "eventName": "MigrationStarted"
    },
    {
        "id": "e828079b-c974-4822-977e-f12ac67380db",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "createdTime": "2022-06-11T00:06:21.526778Z",
        "eventName": "NewCommerceSubscriptionCreated"
    },
    {
        "id": "7dbdcbd5-7a87-4d9b-bf1f-d9298493e631",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "createdTime": "2022-06-11T00:08:08.5185085Z",
        "eventName": "NewCommerceSubscriptionProvisioned"
    },
    {
        "id": "71a3f753-55ca-461e-807d-f541685d5c8b",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "createdTime": "2022-06-11T00:10:07.6947014Z",
        "eventName": "MigrationCompleted"
    }
]

共用方式為