更新新的商務移轉排程

發行項
10/29/2024

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

本文說明如何更新新的商務移轉排程。合作夥伴可以在排程的目標日期之前更新。

重要

此 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	字串	Yes	識別客戶的 GUID 格式字串。
scheduleID	字串	Yes	識別排程的 GUID 格式字串

要求標頭

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

要求本文

下表描述要求本文中的訂用帳戶屬性。

屬性	型別	必要項目	說明
currentSubscriptionId	字串	Yes	訂用帳戶標識碼，指出哪些訂用帳戶需要移轉驗證。不允許進行更新作業。
termDuration	字串	No	移轉的字詞持續時間。
billingCycle	字串	No	移轉的計費週期。
purchaseFullTerm	bool	No	移轉是否繼續目前的舊版字詞，或啟動新的字詞。
數量	int	No	您可以在移轉時增加或減少訂用帳戶的授權數量。
customTermEndDate	Datetime	No	結束日期可以設定為與現有的非trial 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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"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": "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"
}

共用方式為