建立新的商務移轉

文章
10/14/2023

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

如何建立訂用帳戶至新商務體驗的移轉

必要條件

認證，如合作夥伴中心驗證所述。此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
客戶識別碼 (customer-tenant-id)。如果您不知道客戶的識別碼，您可以在合作夥伴中心中選取 [客戶 ] 工作區，然後從客戶清單中查看客戶，然後 從 [帳戶 ]。在客戶的 [帳戶] 頁面上，尋找 [客戶帳戶資訊] 區段中的 [Microsoft 識別碼]。 Microsoft 識別碼與客戶識別碼 (customer-tenant-id) 相同。
目前的訂用帳戶識別碼

速率限制

建立移轉 API 限制是在 5 分鐘內由合作夥伴呼叫 100 次。如需速率限制和節流的詳細資訊，請參閱 API 節流指引。

REST 要求

要求語法

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

URI 參數

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

名稱	類型	必填	描述
customer-tenant-id	string	Yes	識別客戶的 GUID 格式字串。

要求標頭

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

要求本文

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

屬性	型別	必填	描述
currentSubscriptionId	string	Yes	訂用帳戶識別碼，指出哪些訂用帳戶需要移轉驗證。
termDuration	string	No	移轉時可以變更字詞持續時間。
billingCycle	string	No	移轉時可以變更計費週期。
purchaseFullTerm	bool	No	移轉後，可以在 NCE 中啟動新的字詞。
數量	int	No	您可以在移轉時增加或減少訂用帳戶的授權數量。
customTermEndDate	Datetime	No	結束日期可以設定為與現有的非trial 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": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "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": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "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": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "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": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}

Share via