获取订阅的 Azure 权利
适用于:合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心
合作伙伴可以使用此 API 查看订阅的 Azure 权利,该 API 可获取客户的订阅标识符权利。
先决条件
- 合作伙伴中心身份验证中所述的凭据。 此方案支持使用独立应用和 App+User 凭据进行身份验证。
- Customer_id。
- Subscription_id。
- Entitlement_id。
C#
若要取消 Azure 订阅,需要标识要取消的 Azure 订阅的客户 ID、订阅 ID 和权利 ID。
若要获取客户,请参阅 “按 ID 获取客户”和 “按客户 ID 获取客户 - REST API ”以获取更多帮助。
若要获取订阅,请参阅 按 ID 获取订阅和 按 ID 获取订阅 - REST API 获取更多帮助。
若要获取权利,请参阅 获取订阅的 Azure 权利 - REST API。
REST 请求
请求语法
方法 | 请求 URI |
---|---|
POST | {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id} HTTP/1.1 |
URI 参数
下表列出了取消 Azure 订阅所需的查询参数。
Name | 类型 | 必填 | 描述 |
---|---|---|---|
customer_id | 字符串 | Y | 该值是表示客户的标识符的字符串。 |
subscription_id | 字符串 | Y | 该值是表示客户的标识符的字符串。 |
entitlement_id | 字符串 | Y | 该值是表示 Azure 订阅权利标识符的字符串。 |
请求标头
请参阅 合作伙伴中心 REST 标头。
请求正文
不需任何请求正文。
请求示例
GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}
HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
REST 响应
如果成功,此方法在响应正文中返回 订阅 资源的 Azure 权利。
响应的成功和错误代码
每个响应都有一个 HTTP 状态代码,指示成功或失败以及更多的调试信息。 使用网络跟踪工具读取此代码、错误类型和其他参数。 如需完整列表,请参阅合作伙伴中心 REST 错误代码。
HTTP 状态 | HTTP 代码 | 错误代码 | 描述 |
---|---|---|---|
BadRequest | 400 | 900118 | 客户 ID 无效。 |
BadRequest | 400 | 800002 | 客户 ID {0} 应具有 GUID 格式(xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxx)。 |
BadRequest | 400 | 800002 | 需要订阅 ID。 |
BadRequest | 400 | 800002 | 权利 ID 是必需的。 |
BadRequest | 400 | 800002 | 需要 Azure 权利取消请求内容。 |
禁止 | 403 | 900159 | 帐户 ID {0} 和组织 ID 的合作伙伴与具有帐户 ID {2} 和组织 ID {1}{3}的客户没有商业关系。 |
BadRequest | 400 | 900307 | 取消原因 “{0} 无效。 |
NotFound | 404 | 800111 | 找不到 ID 的 {0} Azure 权利。 |
响应示例
响应返回给定客户的 Azure 权利。
HTTP
HTTP/1.1 200 OK
Content-Length: 1132
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 6eacec93-852d-4167-9d96-c57809bea7ed
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT
{
"id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
"friendlyName": " Cancel_Azure_Subscription",
"status": “inactive",
"subscriptionId": "065eefc4-915b-453d-c558-152e39ec25b1",
"links": {
"self": {
"uri": "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/065eefc4-915b-453d-c558-152e39ec25b1/azureEntitlements/5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
"method": "GET",
"headers": []
}
}
后续步骤
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈