更新新的商務移轉排程
適用于:合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |適用于 Microsoft Cloud for US Government 的合作夥伴中心
本文說明如何更新新的商務移轉排程。 合作夥伴可以在排程的目標日期之前更新。
重要
此 API 目前僅適用于沙箱租使用者。
必要條件
認證,如合作夥伴中心驗證所述。 此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
客戶識別碼 (
customer-tenant-id
)。 如果您不知道客戶的識別碼,您可以選取 [客戶] 工作區,然後從客戶清單中選取客戶,然後從客戶清單中查詢該識別碼,然後查閱合作夥伴中心。 在客戶的 [帳戶] 頁面上,尋找 [客戶帳戶資訊] 區段中的 [Microsoft 識別碼] 。 Microsoft 識別碼與客戶識別碼 ()customer-tenant-id
相同。目前的訂用帳戶識別碼
REST 要求
要求的語法
方法 | 要求 URI |
---|---|
PUT | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID} |
URI 參數
下表列出建立新商務移轉所需的查詢參數。
名稱 | 類型 | 必要 | 說明 |
---|---|---|---|
customer-tenant-id | string | Yes | 用來識別客戶的 GUID 格式字串。 |
scheduleID | string | Yes | 識別排程的 GUID 格式字串 |
要求標頭
如需詳細資訊,請參閱合作夥伴中心 REST 標頭。
要求本文
下表描述要求本文中的 訂閱 屬性。
屬性 | 型別 | 必要 | 說明 |
---|---|---|---|
currentSubscriptionId | string | Yes | 表示哪個訂用帳戶需要驗證以進行移轉的訂用帳戶識別碼。 不允許進行更新作業。 |
termDuration | 字串 | No | 您可以在移轉時指定字詞持續時間以變更。 |
billingCycle | 字串 | No | 您可以在移轉時指定計費週期以變更。 |
purchaseFullTerm | bool | No | 在移轉時,可以在 NCE 中啟動新的字詞。 |
quantity | int | 否 | 在移轉時,可以增加或減少訂用帳戶的授權數量。 |
customTermEndDate | Datetime | No | 結束日期可以設定為與現有的非試用版 OnlineServicesNCE 訂用帳戶或行事曆月份一致。 如需有關對齊訂閱結束日期的詳細資訊,請參閱這裡: 在合作夥伴中心對齊訂閱結束日期 |
targetDate | Datetime | No | 排程移轉的目標日期。 如果 targetDate 設定為指定的日期,則 migrationOnRenewal 可以設定為 null 或 false。 |
migrateOnRenewal | bool | No | 如果 migrateOnRenewal 的旗標設定為 true,則不需要指定 targetDate 來排程移轉。 |
要求範例
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00"
}
REST 回應
如果成功,這個方法會傳迴響應本文中移轉 (移轉物件) 的 訂 用帳戶詳細資料。
回應成功和錯誤碼
每個回應都隨附 HTTP 狀態碼,會指出成功與否以及其他的偵錯資訊。 請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。 如需完整清單,請參閱合作夥伴中心的 REST 錯誤碼。
回應範例
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"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"
}
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應