取得新的商務移轉排程
適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府Microsoft雲端合作夥伴中心
本文說明如何取得新的商務移轉排程。
重要
此 API 目前僅適用於沙箱租使用者。
必要條件
憑證，如合作夥伴中心驗證所述。 此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
客戶識別碼 (
customer-tenant-id)。 如果您不知道客戶的標識碼，您可以在 合作夥伴中心 中選取 [客戶] 工作區，然後從客戶清單中找到該客戶，接著選取 [帳戶]。 在客戶的 [帳戶] 頁面上，尋找 [客戶帳戶資訊] 區段中的 [Microsoft 識別碼]。 Microsoft 識別碼與客戶識別碼 (customer-tenant-id) 相同。目前的訂用帳戶標識碼
REST 要求
合作夥伴可以查詢的方式有兩種不同的方式。
- 合作夥伴可以查詢以取得特定排程
- 合作夥伴可以查詢以取得特定準則的排程清單
請求語法
| 方法 | 要求 URI |
|---|---|
| GET | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID} |
URI 參數
下表列出建立新商務移轉所需的查詢參數。
| 名稱 | 類型 | 必要項目 | 說明 |
|---|---|---|---|
| customer-tenant-id | 字串 | Yes | 識別客戶的 GUID 格式字串。 |
| 方法 | 要求 URI |
|---|---|
| GET | {baseURL}/v1/migrations/newcommerce/schedules？CustomerTenantId={customer-tenant-id} |
URI 參數
下表列出建立新商務移轉所需的查詢參數。 您可以使用任何查詢參數。
| 名稱 | 類型 | 說明 |
|---|---|---|
| 客戶租戶ID | 字串 | 識別客戶的 GUID 格式字串。 |
| 當前訂閱識別碼 | 字串 | 用於識別當前訂用帳戶 ID 的 GUID 格式字串 |
| 外部參考ID | 字串 | 識別移轉批次的 GUID 格式字串 |
請求標頭
如需詳細資訊，請參閱合作夥伴中心 REST 標頭。
回應內容
下表描述了回應中的訂閱屬性。
| 屬性 | 類型 | 必要項目 | 說明 |
|---|---|---|---|
| currentSubscriptionId | 字串 | Yes | 訂用帳戶標識碼，指出哪些訂用帳戶需要移轉驗證。 |
| 有效期間 | 字串 | 否 | 適用於移轉的期限。 |
| billingCycle | 字串 | 不 | 適用於遷移的計費週期。 |
| 購買完整期限 | bool | 否 | 移轉是否開始新的任期。 |
| 數量 | int (整數型) | 不 | 您可以在移轉時增加或減少訂用帳戶的授權數量。 |
| 自訂期限結束日期 | 日期時間 | 不 | 結束日期可以設定為與現有的非試用 OnlineServicesNCE 訂用帳戶或行事曆月份一致。 如需對齊訂用帳戶結束日期的詳細資訊，請參閱這裡： 在合作夥伴中心對齊訂用帳戶結束日期 |
| 目標日期 | 日期時間 | 否 | 排程移轉的目標日期。 |
| 在續約時遷移 | 布林 | 否 | 顯示行程是否需要在續約時執行 |
| 狀態 | 字串 | 不 | 排程移轉的狀態 |
| 創建時間 | 日期時間 | 不 | 建立排程時 |
| 最後修改時間 | 日期時間 | 否 | 上次修改排程的時間 |
REST 回應
如果成功，這個方法會在回應本文中傳回正在移轉的訂閱詳細數據（移轉物件）。
回應成功和錯誤碼
每個回應都有一個 HTTP 狀態代碼，指出成功或失敗，以及進一步的偵錯資訊。 使用網路追蹤工具來讀取此程式代碼、錯誤類型等等參數。 如需完整清單，請參閱合作夥伴中心的 REST 錯誤碼。
回應範例
[
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00",
"createdTime": "2022-10-18T21:20:50.9668605+00:00",
"lastModifiedTime": "2022-10-18T21:29:32.8992819+00:00"
}
]