取得新的商務移轉排程
適用於：合作夥伴中心 |由 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 參數
下表列出建立新商務移轉所需的查詢參數。 您可以使用任何查詢參數。
| 名稱 | 類型 | 說明 |
|---|---|---|
| customerTenantId | 字串 | 識別客戶的 GUID 格式字串。 |
| currentSubscriptionID | 字串 | 識別目前訂用帳戶標識碼的 GUID 格式字串 |
| externalReferenceID | 字串 | 識別移轉批次的 GUID 格式字串 |
要求標頭
如需詳細資訊，請參閱合作夥伴中心 REST 標頭。
回應本文
下表描述回應中的訂用帳戶屬性。
| 屬性 | 型別 | 必要項目 | 說明 |
|---|---|---|---|
| currentSubscriptionId | 字串 | Yes | 訂用帳戶標識碼，指出哪些訂用帳戶需要移轉驗證。 |
| termDuration | 字串 | No | 套用至移轉的字詞持續時間。 |
| billingCycle | 字串 | No | 套用至移轉的計費週期。 |
| purchaseFullTerm | bool | No | 移轉是否開始新的字詞。 |
| 數量 | int | No | 您可以在移轉時增加或減少訂用帳戶的授權數量。 |
| customTermEndDate | Datetime | No | 結束日期可以設定為與現有的非trial OnlineServicesNCE 訂用帳戶或行事曆月份一致。 如需對齊訂用帳戶結束日期的詳細資訊，請參閱這裡： 在合作夥伴中心對齊訂用帳戶結束日期 |
| targetDate | Datetime | No | 排程移轉的目標日期。 |
| migrateOnRenewal | bool | No | 指出排程是否需要在更新時發生 |
| status | 字串 | No | 排程移轉的狀態 |
| createdTime | Datetime | No | 建立排程時 |
| lastModifiedTime | Datetime | No | 上次修改排程的時間 |
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"
}
]