共用方式為


排程新的商務移轉

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

適當的角色:系統管理員代理程式 |銷售代理程式

本文說明如何排程新的商務體驗。

必要條件

REST 要求

要求語法

方法 要求 URI
POST {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules

URI 參數

下表列出建立新商務移轉所需的查詢參數。

名稱 輸入 必要項目 說明
customer-tenant-id 字串 Yes 識別客戶的 GUID 格式字串。

要求標頭

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

要求本文

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

屬性 型別 必要項目 說明
currentSubscriptionId 字串 Yes 訂用帳戶標識碼,指出哪些訂用帳戶需要移轉驗證。
termDuration 字串 No 您可以在移轉時指定要變更的字詞持續時間。
billingCycle 字串 No 您可以在移轉時指定計費週期來變更。
purchaseFullTerm bool No 移轉后,可以在NCE中啟動新的字詞。
數量 int No 您可以在移轉時增加或減少訂用帳戶的授權數量。
customTermEndDate Datetime No 結束日期可以設定為與現有的非試用版 OnlineServicesNCE 訂用帳戶或行事曆月份一致。 如需對齊訂用帳戶結束日期的詳細資訊,請參閱這裡: 在合作夥伴中心對齊訂用帳戶結束日期
targetDate Datetime 必要專案 (如果 migrateOnRenewal 為 null/false) 排程移轉的目標日期。 如果 targetDate 是針對指定的日期設定,則 migrationOnRenewal 可以設定為 null 或 false。
migrateOnRenewal bool 必要專案(如果 targetDate 為 null) 如果 migrateOnRenewal 的旗標設定為 true,就不需要指定 targetDate 來排程移轉。
addOnMigrationSchedules bool No 包含排程移轉中要包含的 AddOn 訂用帳戶清單。

要求範例

{
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

REST 回應

如果成功,這個方法會傳回回應本文中要移轉的訂用帳戶詳細數據(移轉物件)。

回應成功和錯誤碼

每個回應都隨附 HTTP 狀態碼,會指出成功與否以及其他的偵錯資訊。 請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。 如需完整清單,請參閱合作夥伴中心的 REST 錯誤碼

回應範例

{
    "id": "f016c025-a873-47af-8b52-2516fbef4c65",
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

另請參閱