创建新商务迁移
适用于:合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | 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 限制指南。
方法 | 请求 URI |
---|---|
POST | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce HTTP/1.1 |
下表列出了创建新的商业迁移所需的查询参数。
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
customer-tenant-id | string | 是 | 一个 GUID 格式的字符串,用于标识客户。 |
有关详细信息,请参阅合作伙伴中心 REST 标头。
下表描述了 请求正文中的订阅 属性。
properties | 类型 | 必需 | 说明 |
---|---|---|---|
currentSubscriptionId | string | 是 | 一个订阅标识符,指示哪个订阅需要对迁移进行验证。 |
termDuration | string | 否 | 迁移后,可以更改术语持续时间。 |
billingCycle | string | 否 | 迁移后,可以更改计费周期。 |
purchaseFullTerm | 布尔 | 否 | 迁移后,可以在 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"
}
]
}
如果成功,此方法在响应正文中返回要迁移的 订阅 (迁移对象)的详细信息。
每个响应都有一个 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
}