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

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

注意

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

先决条件

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

重要

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

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

C#

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

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

    var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);
    
  2. 使用 “激活”操作激活 订阅。

    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/87363db7-39ab-dd25-d371-94340aaa2f97/activate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
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: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

{
    "subscriptionId":"87363db7-39ab-dd25-d371-94340aaa2f97",
    "status":"Success"
}