Share via

获取向新商务体验的迁移计划

  • 项目

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

本文介绍如何获取新的商业迁移计划。

重要

此 API 目前仅在沙盒租户中可用。

必备条件

  • 合作伙伴中心身份验证中所述的凭据。 此方案支持使用独立应用和应用+用户凭据进行身份验证。

  • 客户 ID (customer-tenant-id)。 如果不知道客户的 ID，可以通过选择“客户”工作区、客户列表中的“客户”和“帐户”，在合作伙伴中心中查找该 ID。 在客户的“帐户”页上的“客户帐户信息” 部分查找 Microsoft ID。 Microsoft ID 与客户 ID (customer-tenant-id) 相同。

  • 当前订阅 ID

REST 请求

合作伙伴可通过两种不同的方式进行查询。

  • 查询特定计划
  • 获取给定条件的计划列表

请求语法

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

URI 参数

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

名称 类型 必需 说明
customer-tenant-id 字符串 是 一个 GUID 格式的字符串，用于标识客户。
方法 请求 URI
GET {baseURL}/v1/migrations/newcommerce/schedules？CustomerTenantId={customer-tenant-id}

URI 参数

下表列出了创建新的商业迁移所需的查询参数。 可以使用任何查询参数。

名称 类型 说明
customerTenantId 字符串 一个 GUID 格式的字符串，用于标识客户。
currentSubscriptionID string 标识当前订阅 ID 的 GUID 格式字符串
externalReferenceID string 标识迁移批处理的 GUID 格式字符串

请求标头

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

响应正文

此表描述了响应中的 订阅 属性。

Property 类型 必需 说明
currentSubscriptionId 字符串 是 一个订阅标识符，指示哪个订阅需要迁移验证。
termDuration string 否 可以指定要在迁移时更改的期限持续时间。
billingCycle string 否 可以指定在迁移时更改计费周期。
purchaseFullTerm bool 否 迁移后，可以在 NCE 中启动新术语。
quantity int 否 可以在迁移时增加或减少订阅的许可证数量。
customTermEndDate datetime 否 可以将结束日期设置为与现有非试用版 OnlineServicesNCE 订阅或日历月份保持一致。 此处提供了有关调整订阅结束日期的详细信息： 在合作伙伴中心调整订阅结束日期
targetDate datetime 否 计划迁移的目标日期。
migrateOnRenewal bool 否 指示计划是否需要在续订时发生
status 字符串 否 计划迁移的状态
createdTime datetime 否 创建计划的时间
lastModifiedTime datetime 否 上次修改计划的时间

REST 响应

如果成功，此方法将在响应正文中 (迁移对象) 返回要迁移的 订阅 的详细信息。

响应的成功和错误代码

每个响应都带有一个 HTTP 状态代码，用于指示成功或失败以及其他调试信息。 请使用网络跟踪工具来读取此代码、错误类型和其他参数。 如需完整列表，请参阅合作伙伴中心 REST 错误代码。

响应示例

[
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00",
"createdTime": "2022-10-18T21:20:50.9668605+00:00",
"lastModifiedTime": "2022-10-18T21:29:32.8992819+00:00"
}
]

另请参阅