创建向新商务体验的迁移

项目
10/14/2023

适用于：合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心

如何创建订阅到新商务体验的迁移

先决条件

合作伙伴中心身份验证中所述的凭据。此方案支持使用独立应用和 App+User 凭据进行身份验证。
客户 ID (customer-tenant-id)。如果不知道客户的 ID，可以通过选择“客户”工作区，然后从客户列表中选择客户，然后选择“帐户”，在合作伙伴中心中查找该 ID。在客户的“帐户”页上的“客户帐户信息”部分查找 Microsoft ID。 Microsoft ID 与客户 ID (customer-tenant-id) 相同。
当前订阅 ID

速率限制

创建迁移 API 限制在 5 分钟内由合作伙伴调用 100 次。有关速率限制和限制的详细信息，请参阅 API 限制指南。

REST 请求

请求语法

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

URI 参数

下表列出了创建新的商业迁移所需的查询参数。

名称	Type	需要	说明
customer-tenant-id	string	是	一个 GUID 格式的字符串，用于标识客户。

请求标头

有关详细信息，请参阅合作伙伴中心 REST 标头。

请求正文

下表描述了请求正文中的订阅属性。

properties	类型	需要	说明
currentSubscriptionId	string	是	一个订阅标识符，指示哪个订阅需要对迁移进行验证。
termDuration	string	否	迁移后，可以更改术语持续时间。
billingCycle	string	否	迁移后，可以更改计费周期。
purchaseFullTerm	bool	否	迁移后，可以在 NCE 中启动新术语。
quantity	int	否	迁移后，可以增加或减少订阅的许可证数量。
customTermEndDate	datetime	否	可以将结束日期设置为与现有的非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