获取订阅注册状态

项目
02/05/2024

如何获取已启用用于购买 Azure 虚拟机预留实例的客户订阅的订阅注册状态。

若要使用合作伙伴中心 API 购买 Azure 虚拟机预留实例，必须至少有一个现有的 CSP Azure 订阅。注册订阅方法允许注册现有的 CSP Azure 订阅，使其能够购买 Azure 虚拟机预留实例。此方法允许检索该注册的状态。

必备条件

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

C#

若要获取订阅的注册状态，请首先使用带有客户 ID 的 IAggregatePartner.Customers.ById 方法来标识客户。然后，通过使用订阅 ID 调用 Subscription.ById () 方法来获取订阅操作的接口，以标识订阅。接下来，使用 RegistrationStatus 属性获取指向当前订阅的注册状态操作的接口，并调用 Get 或 GetAsync 方法来检索 SubscriptionRegistrationStatus 对象。

// IAggregatePartner partnerOperations;
// var selectedCustomerId;
// var selectedSubscriptionId;

// Retrieve a subscription's registration status details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).RegistrationStatus.Get();

REST 请求

请求语法

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

URI 参数

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

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

请求标头

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

请求正文

无。

请求示例

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-id>/subscriptions/<subscription-id>/registrationstatus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-CorrelationId: ec8f62e5-1d92-47e9-8d5d-1924af105123
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive

REST 响应

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

响应的成功和错误代码

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

响应示例

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-RequestId: ec8f62e5-1d92-47e9-8d5d-1924af105123
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344

{
    "subscriptionId":"<subscription-id>",
    "status":"NotRegistered",
    "attributes":{
        "objectType":"SubscriptionRegistrationStatus"
    }
}

通过