取得新的商務移轉排程

適用于：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |適用于 Microsoft Cloud for US Government 的合作夥伴中心

本文說明如何取得新的商務移轉排程。

重要

此 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	string	Yes	用來識別客戶的 GUID 格式字串。

方法	要求 URI
GET	{baseURL}/v1/migrations/newcommerce/schedules？CustomerTenantId={customer-tenant-id}

URI 參數

下表列出建立新商務移轉所需的查詢參數。 您可以使用任何查詢參數。

名稱	類型	說明
customerTenantId	string	用來識別客戶的 GUID 格式字串。
currentSubscriptionID	string	識別目前訂用帳戶識別碼的 GUID 格式字串
externalReferenceID	string	識別移轉批次的 GUID 格式字串

要求標頭

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

回應本文

下表描述回應中的 訂閱 屬性。

屬性	型別	必要	說明
currentSubscriptionId	string	Yes	表示哪個訂用帳戶需要驗證以進行移轉的訂用帳戶識別碼。
termDuration	字串	No	您可以在移轉時指定字詞持續時間以變更。
billingCycle	字串	No	您可以在移轉時指定計費週期以變更。
purchaseFullTerm	bool	No	在移轉時，可以在 NCE 中啟動新的字詞。
quantity	int	否	在移轉時，可以增加或減少訂用帳戶的授權數量。
customTermEndDate	Datetime	No	結束日期可以設定為與現有的非試用版 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": "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"
}
]

另請參閱

• 排程新的商務移轉
• 更新新的商務移轉排程
• 取消新的商務移轉排程