通过

获取订阅的 Azure 权利

  • 项目

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

合作伙伴可以使用此 API 查看订阅的 Azure 权利，该 API 可获取客户的订阅标识符权利。

先决条件

  • 合作伙伴中心身份验证中所述的凭据。 此方案支持使用独立应用和 App+User 凭据进行身份验证。
  • Customer_id。
  • Subscription_id。
  • Entitlement_id。

C#

若要取消 Azure 订阅，需要标识要取消的 Azure 订阅的客户 ID、订阅 ID 和权利 ID。

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: aaaa0000-bb11-2222-33cc-444444dddddd

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: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT

{ 
    "id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f", 
    "friendlyName": " Cancel_Azure_Subscription", 
    "status": “inactive", 
    "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e", 
    "links": { 
        "self": { 
            "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f", 
            "method": "GET", 
            "headers": [] 
        } 
    }

相关内容