# 查看授权列表 #### 功能介绍 查询授权列表 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/OSM/doc?api=ListAuthorizations)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### URI GET /v2/servicerequest/authorizations 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | sub_customer_name | 否 | String | 子账号名称 最小长度：**0** 最大长度：**64** | | incident_id | 否 | String | 工单id 最小长度：**0** 最大长度：**32** | | status | 否 | Integer | 授权状态，-1：初始化状态 0：待授权 1：已授权 2：已拒绝 3：已过期 4：已撤回 5：已取消 6：授权审批中 7：授权审批被驳回 最小值：**-1** 最大值：**10** | | simple_description | 否 | String | 工单简要描述 最小长度：**0** 最大长度：**64** | | offset | 否 | Integer | 查询偏移量 最小值：**0** 最大值：**65535** 缺省值：**0** | | limit | 否 | Integer | 查询限制条数 最小值：**1** 最大值：**100** 缺省值：**10** | | group_id | 否 | String | 华为云IAM组id，涉及同组其他工单的操作时，该id必传 最小长度：**0** 最大长度：**64** | | trim_osm_rich_text_label | 否 | Boolean | 是否去除富文本 缺省值：true | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：**1** 最大长度：**5000** | | X-Language | 否 | String | 语言环境，值为通用的语言描述字符串，比如zh-cn等，默认为zh-cn。 会根据语言环境对应展示一些国际化的信息，比如工单类型名称等。 最小长度：**1** 最大长度：**32** | | X-Time-Zone | 否 | String | 环境时区，值为通用的时区描述字符串，比如GMT+8等，默认为GMT+8。 涉及时间的数据会根据环境时区处理。 最小长度：**1** 最大长度：**32** | #### 响应参数 **状态码： 200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | count | Integer | 总数 最小值：**0** 最大值：**9223372036854775807** | | incident_auth_list | Array of [IncidentOrderAuthV2] objects | 授权列表 数组长度：**1 - 5** | 表4IncidentOrderAuthV2 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 授权id 最小长度：**1** 最大长度：**32** | | status | Integer | 授权状态，-1：初始化状态 0：待授权 1：已授权 2：已拒绝 3：已过期 4：已撤回 5：已取消 6：授权审批中 7：授权审批被驳回 最小值：**-1** 最大值：**10** | | incident_id | String | 工单id 最小长度：**1** 最大长度：**64** | | simple_description | String | 工单简要描述 最小长度：**1** 最大长度：**2000** | | auth_describe | String | 授权描述 最小长度：**1** 最大长度：**2000** | | resource_type_id | String | 授权资源类型id 最小长度：**1** 最大长度：**64** | | resource_type_name | String | 授权资源类型名称 最小长度：**1** 最大长度：**64** | | visit_type_id | String | 授权访问类型id 最小长度：**1** 最大长度：**64** | | visit_type_name | String | 授权访问类型名称 最小长度：**1** 最大长度：**64** | | create_time | String | 创建时间 | | auth_effective_time | String | 授权生效时间 | | auth_expire_time | String | 授权到期时间 | | reject_reason | String | 拒绝原因 最小长度：**0** 最大长度：**300** | | customer_id | String | 主账号id 最小长度：**1** 最大长度：**64** | | x_customer_id | String | 子用户id 最小长度：**0** 最大长度：**64** | | xcustomer_name | String | 子用户名称 最小长度：**0** 最大长度：**256** | | content_of_auth_letter | String | 承诺书内容 最小长度：**0** 最大长度：**20000** | #### 请求示例 ``` GET https://{endpoint}/v2/servicerequest/authorizations?incident_id=test-123 ``` #### 响应示例 **状态码： 200** 成功返回200 ``` { "count" : "123", "incident_auth_list" : [ { "id" : "123", "status" : 0, "incident_id" : "test-123", "simple_description" : "test", "resource_type_id" : "2", "resource_type_name" : "华为云账号", "visit_type_id" : "4", "visit_type_name" : "控制台登录", "auth_effective_time" : "2020-07-07T09:33:43.000Z", "auth_expire_time" : "2020-07-07T09:33:43.000Z", "reject_reason" : null, "create_time" : "2020-07-07T09:33:43.000Z", "customer_id" : "customer-123", "x_customer_id" : "x-customer-123", "xcustomer_name" : "test", "content_of_auth_letter" : "" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 成功返回200 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ticket/ErrorCode.html)。