查詢新的商務移轉
適用於:合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心
如何根據客戶標識碼、目前的訂用帳戶標識碼或外部參考標識碼來查詢已移轉的訂用帳戶
適當的角色:全域管理員 |管理員 代理程式 |銷售代理程式
必要條件
- 認證,如合作夥伴中心驗證所述。 此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
此 API 可以根據合作夥伴選取的查詢字串進行篩選。 選取的查詢字串可以是下列三個選項之一:
CustomerTenantId。 如果您不知道客戶的標識碼,您可以在合作夥伴中心中選取 [客戶] 工作區,然後從客戶清單中查看客戶,然後從 [帳戶]。 在客戶的 [帳戶] 頁面上,在 [客戶帳戶資訊] 區段中尋找 Microsoft 標識符。 Microsoft識別碼與客戶標識符相同。
CurrentSubscriptionId (已移轉之訂用帳戶的舊版標識符)
ExternalReferenceId (批次移轉工具傳回的批次識別符,可透過合作夥伴中心 SDK 下載)
REST 要求
要求語法
方法 | 要求 URI |
---|---|
GET | {baseURL}/v1/migrations/newcommerce HTTP/1.1 |
查詢字串
下表列出篩選和擷取新商務移轉所需的查詢字串。 成功查詢移轉需要三個標識碼中的至少一個。 接受要查詢的多個標識碼,但不需要。
名稱 | 描述 |
---|---|
CustomerTenantId | 識別客戶的 GUID 格式字串。 |
CurrentSubscriptionId | GUID 格式的字串,可識別已移轉的舊版訂用帳戶。 |
ExternalReferenceId | 識別移轉批次的 GUID 格式字串。 |
要求標頭
如需詳細資訊,請參閱合作夥伴中心 REST 標頭。 API 的回應最多會傳回 300 個頁面記錄。 如果在輸入的查詢中傳回超過 300 筆記錄,響應標頭中會提供接續令牌。 接續令牌可以在下列要求的標頭中輸入,以傳回查詢的額外頁面記錄。
要求本文
無。
REST 回應
如果成功,這個方法會傳回響應主體中已移轉的訂用帳戶詳細數據(移轉物件)。 這包括移轉標識碼。
回應成功和錯誤碼
每個回應都有一個 HTTP 狀態代碼,指出成功或失敗和其他偵錯資訊。 使用網路追蹤工具來讀取此程式代碼、錯誤類型和其他參數。 如需完整清單,請參閱合作夥伴中心的 REST 錯誤碼。
要求 URL 範例
baseurl/v1/migrations/newcommerce?CustomerTenantId=83c51838-fed5-44a4-a275-afa201d53699&CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833&ExternalReferenceId=9ab61899-0b2b-4320-bd6d-8196c53607d6
baseurl/v1/migrations/newcommerce?CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833
回應範例
[
{
"addOnMigrations": [],
"id": "8ce7115e-0324-41b1-8ca3-7c7ae3b64f75",
"startedTime": "2022-02-24T23:50:30.4384819Z",
"completedTime": "2022-02-24T23:53:14.0813711Z",
"currentSubscriptionId": "9E289691-2FF3-419D-B39B-26B3E5A817FB",
"status": "Completed",
"customerTenantId": "ce6fcc21-c276-447b-9605-874decb9024b",
"catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
"newCommerceSubscriptionId": "f2d6534b-9e30-4cf5-c7b0-5d6393dbf12d",
"newCommerceOrderId": "09714c93092a",
"subscriptionEndDate": "2023-02-14T00:00:00Z",
"quantity": 2,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"externalReferenceId": "771317a4-275d-47d9-9724-3eefa4a168ad"
}
]
意見反映
https://aka.ms/ContentUserFeedback。
即將推出:我們會在 2024 年淘汰 GitHub 問題,並以全新的意見反應系統取代並作為內容意見反應的渠道。 如需更多資訊,請參閱:提交及檢視以下的意見反映: