激活商业市场 SaaS 产品的沙盒订阅以启用计费

项目
03/14/2024

如何从集成沙盒帐户激活商业市场软件即服务（SaaS）产品的订阅，以启用计费。

注意

只能从集成沙盒帐户激活商业市场 SaaS 产品的订阅。如果你有生产订阅，则必须访问发布者的站点才能完成设置过程。订阅计费只有在设置完成后才会开始。

先决条件

合作伙伴中心身份验证中所述的凭据。此方案支持使用独立应用和 App+User 凭据进行身份验证。
集成沙盒合作伙伴帐户，客户拥有商业市场 SaaS 产品的活动订阅。
对于使用合作伙伴中心 .NET SDK 的合作伙伴，必须使用 SDK 版本 1.14.0 或更高版本才能访问此功能。

重要

截至 2023 年 6 月，最新的合作伙伴中心 .NET SDK 版本 3.4.0 现已存档。可以从 GitHub 下载 SDK 版本，以及包含有用信息的自述文件。

建议合作伙伴继续使用合作伙伴中心 REST API。

C#

使用以下步骤激活商业市场 SaaS 产品的订阅：

使订阅操作的接口可用。必须标识客户并指定试用订阅的订阅标识符。

var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);

使用 “激活”操作激活 订阅。

var subscriptionActivationResult = subscriptionOperations.Activate();

REST 请求

请求语法

方法	请求 URI
POST	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/activate HTTP/1.1

URI 参数

名称	Type	需要	说明
customer-tenant-id	guid	Y	该值是 GUID 格式的客户租户标识符（customer-tenant-id），可用于指定客户。
subscription-id	guid	Y	该值是 GUID 格式的订阅标识符（subscription-id），可用于指定订阅。

请求标头

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

请求正文

无。

请求示例

POST https://api.partnercenter.microsoft.com/v1/customers/42b5f772-5c5c-4bce-b9d7-bdadeecca411/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/activate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

REST 响应

此方法返回 订阅 ID 和状态属性。

响应的成功和错误代码

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

响应示例

HTTP/1.1 200 OK
Content-Length: 79
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

{
    "subscriptionId":"aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "status":"Success"
}

通过