计划新商务迁移

项目
09/20/2024

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

相应的角色：管理员代理 | 销售代理

本文介绍如何安排新的商务体验。

先决条件

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

REST 请求

请求语法

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

URI 参数

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

Name	类型	必填	描述
customer-tenant-id	string	是	一个 GUID 格式的字符串，用于标识客户。

请求标头

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

请求正文

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

属性	类型	必填	描述
currentSubscriptionId	string	是	一个订阅标识符，指示哪个订阅需要对迁移进行验证。
termDuration	string	否	可以指定在迁移时更改术语持续时间。
billingCycle	string	否	可以在迁移时指定计费周期来更改。
purchaseFullTerm	布尔	否	迁移后，可以在 NCE 中启动新术语。
quantity	int	否	迁移后，可以增加或减少订阅的许可证数量。
customTermEndDate	datetime	否	可以将结束日期设置为与现有的非试用 OnlineServicesNCE 订阅或日历月保持一致。此处提供了有关调整订阅结束日期的详细信息：在合作伙伴中心对齐订阅结束日期
targetDate	datetime	必需（如果 migrateOnRenewal 为 null/false）	计划迁移的目标日期。如果 targetDate 设置为指定日期，则 migrationOnRenewal 可以设置为 null 或 false。
migrateOnRenewal	布尔	必需（如果 targetDate 为 null）	如果为 migrateOnRenewal 设置了标志，则无需指定 targetDate 来计划迁移。
addOnMigrationSchedules	布尔	否	包括计划迁移中要包括的 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
        }
    ]
}

通过