通过

获取订阅预配状态

  • 项目

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

如何获取客户订阅的订阅预配状态。

先决条件

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

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

  • 订阅标识符。

  • 需要对订阅具有委派的管理员权限才能执行此操作。

精细委派的管理员权限 （GDAP） 角色

至少需要以下 GDAP 角色之一：

  • 目录读取者
  • 全局读取者

C#

若要获取订阅的预配状态，请首先使用 具有客户 ID 的 IAggregatePartner.Customers.ById 方法来标识客户。 然后，使用订阅 ID 调用 Subscriptions.ById 方法，获取订阅操作的接口。 接下来，使用 ProvisioningStatus 属性获取当前订阅预配状态操作的接口，然后调用 Get 或 GetAsync 方法来检索 SubscriptionProvisioningStatus 对象。

// IAggregatePartner partnerOperations.
// string customerId;
// string subscriptionId;

// Retrieve a subscription's provisioning status.
var provisioningStatus = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionID).ProvisioningStatus.Get();

REST 请求

请求语法

方法 请求 URI
GET {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/provisioningstatus HTTP/1.1

URI 参数

使用以下路径参数标识客户和订阅。

名称 类型​​ 必需 说明
customer-ID string 是 标识客户的 GUID 格式字符串。
subscription-ID string 是 标识订阅的 GUID 格式字符串。

请求标头

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

请求正文

无。

请求示例

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST 响应

如果成功，响应正文将 包含 SubscriptionProvisioningStatus 资源。

响应的成功和错误代码

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

响应示例

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344
Date: Thu, 20 Apr 2017 19:23:39 GMT

{
    "skuId": "6FD2C87F-B296-42F0-B197-1E91E994B900",
    "status": "success",
    "quantity": 5,
    "endDate": "2018-05-10T00:00:00Z",
    "attributes": {
        "objectType": "SubscriptionProvisioningStatus"
    }
}

注解

  • SubscriptionProvisioningStatus 中的状态字段在许可证更改分配期间设置为“挂起”。

  • 状态字段每 15 分钟更新一次。