验证订阅以进行迁移

项目
10/28/2024

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

如何验证要迁移到新商务体验的订阅

先决条件

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

速率限制

验证迁移 API 限制是 5 分钟内每个合作伙伴-客户组合的 450 次调用。有关速率限制和限制的详细信息，请参阅 API 限制指南。

REST 请求

请求语法

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

URI 参数

下表列出了用于验证迁移订阅所需的查询参数。

名称	类型	必需	说明
customer-tenant-id	string	是	一个 GUID 格式的字符串，用于标识客户。
termDuration	string	否	迁移后，可以更改术语持续时间。
billingCycle	string	否	迁移后，可以更改计费周期。
purchaseFullTerm	布尔	否	迁移后，可以在 NCE 中启动新术语。
quantity	int	否	迁移后，可以增加或减少订阅的许可证数量。
customTermEndDate	datetime	否	可以将结束日期设置为与现有的非Trial OnlineServicesNCE 订阅或日历月保持一致。此处提供了有关调整订阅结束日期的详细信息：在合作伙伴中心对齐订阅结束日期

请求标头

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

请求正文

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

properties	类型	必需	说明
currentSubscriptionId	string	是	一个订阅标识符，指示哪个订阅需要对迁移进行验证。

请求示例

"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"

REST 响应

如果成功，此方法在响应正文中返回“isEligible”布尔值，指示当前订阅是否有资格迁移到新商务。请注意，验证迁移 API 不提供有关订阅在新商务中促销资格的信息。

响应的成功和错误代码

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

响应示例

1. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": false,
        "errors": [
            {
                "code": 5,
                "description": "Subscription cannot be migrated to New Commerce because the equivalent offer is not yet available in New Commerce",
            }
        ]
    }

2. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": true,
        "catalogItemId": "CFQ7TTC0LF8S:0002:CFQ7TTC0KSVV"
    }

通过