適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府Microsoft雲端合作夥伴中心
如何創建訂閱到 New Commerce Experience 的遷移
先決條件
合作夥伴中心身份驗證中所述的憑證。 此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
客戶識別碼 (
customer-tenant-id)。 如果您不知道客戶的標識碼，您可以在 合作夥伴中心 中選取 [客戶] 工作區，然後從客戶清單中找到該客戶，接著選取 [帳戶]。 在客戶的 [帳戶] 頁面上，在 [客戶帳戶資訊] 區段中尋找 Microsoft ID。 Microsoft ID 與客戶 ID (customer-tenant-id) 相同。目前的訂用帳戶標識碼
速率限制
創建遷移 API 限制為合作夥伴在 5 分鐘內 100 次調用。 如需速率限制和節流的詳細資訊，請參閱 API 節流指引。
REST 要求
請求語法
| 方法 | 請求網址識別碼 (URI) |
|---|---|
| 貼文 | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce HTTP/1.1 |
URI 參數
下表列出建立新商務移轉所需的查詢參數。
| 名稱 | 類型 | 為必填項目 | 說明 |
|---|---|---|---|
| 客戶租戶識別碼（customer-tenant-id） | 字符串 | 是的 | 識別客戶的 GUID 格式字串。 |
請求標頭
如需詳細資訊，請參閱合作夥伴中心 REST 標頭。
請求主體
下表描述請求正文中的 訂閱 屬性。
| 房產 | 類型 | 為必填項目 | 說明 |
|---|---|---|---|
| currentSubscriptionId（目前訂閱 ID） | 字符串 | 是的 | 訂用帳戶標識碼，指出哪些訂用帳戶需要移轉驗證。 |
| 期限長度 | 字符串 | 否 | 遷移時可以變更期限。 |
| billingCycle | 字符串 | 否 | 移轉時可以變更計費週期。 |
| 購買完整期限 | 布爾 (bool) | 否 | 轉換後，可以在 NCE 中開始新的學期。 |
| 數量 | 整數 | 否 | 您可以在移轉時增加或減少訂用帳戶的授權數量。 |
| 自訂條款結束日期 | 日期時間 | 否 | 結束日期可以設定為與現有的非試用 OnlineServicesNCE 訂用帳戶或行事曆月份一致。 此處有關於對齊訂用帳戶結束日期的詳細資訊： 在合作夥伴中心對齊訂用帳戶結束日期 |
範例請求
注意，嵌套的附加元件（帶有附加元件訂閱的附加元件訂閱）應該作為 addOnMigrations 中的簡單清單寫入請求正文中，而不是嵌套在請求中的其他附加元件訂閱中;請參閱最後一個請求範例，瞭解如何在請求正文中編寫附加元件。
{
"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"
}
{
"currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC",
"termDuration": "P1M",
"billingCycle": "Monthly",
}
{
"currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC",
"purchaseFullTerm": true
}
{
"currentSubscriptionId": "66E738D6-E0BC-4FFB-8818-BDE99BC7008B",
"quantity": 1,
"billingCycle": "Annual",
"purchaseFullTerm": false,
"termDuration": "P1Y",
"addOnMigrations": [
{
"currentSubscriptionId": "359011DC-B5B0-4660-850B-A8FA9B2E3309",
"quantity": 1,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1M"
},
{
"currentSubscriptionId": "159D9F87-CE39-4EBD-B9C2-ECF0892A85A1",
"quantity": 1,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1Y"
}
]
}
REST 響應
如果成功，此方法將在回應正文中返回正在遷移的 訂閱 （遷移物件）的詳細資訊。
回應成功和錯誤碼
每個回應都有一個 HTTP 狀態代碼，指出成功或失敗和額外的偵錯資訊。 使用網路追蹤工具讀取此代碼、錯誤類型和其他參數。 如需完整清單，請參閱合作夥伴中心的 REST 錯誤碼。
回應範例
{
"addOnMigrations": [
{
"currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"catalogItemId": "CFQ7TTC0LH0T:0001:CFQ7TTC0K4KQ",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
},
{
"currentSubscriptionId": "80906BD9-E45C-4D1B-92A8-EA3F3FB6E105",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"catalogItemId": "CFQ7TTC0LH0R:0001:CFQ7TTC0K0SK",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
},
{
"currentSubscriptionId": "72E424F4-10FF-4C76-B101-C274F73BA498",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"catalogItemId": "CFQ7TTC0LHXJ:0001:CFQ7TTC0KHTR",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
}
],
"id": "7123c075-fc05-42d6-a21e-1d2036fa490b",
"startedTime": "2022-02-23T13:00:48.4489832Z",
"currentSubscriptionId": "2E56C7F5-E120-4CA4-BFF3-7DA763B4D777",
"status": "Processing",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
}