
# 查询委托
#### 功能介绍
查询委托
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/OSM/doc?api=ListAgencies)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
GET /v2/servicerequest/agencies
#### 请求参数
表1请求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**
表2响应Body参数 
| 参数          | 参数类型                                                          | 描述                                                                                        |
|:---|:---|:---|
| total_count | Integer                                                       | 总数 最小值：**0** 最大值：**65535** |
| agency_list | Array of [AgencyV2] objects | 委托列表 数组长度：**0 - 65535**                                    |
   
 表3AgencyV2 
| 参数                | 参数类型    | 描述                                                                                              |
|:---|:---|:---|
| id                | String  | 委托id 最小长度：**0** 最大长度：**64**         |
| name              | String  | 委托名称 最小长度：**0** 最大长度：**64**      |
| duration          | String  | 委托的期限 最小长度：**0** 最大长度：**1**      |
| trust_domain_name | String  | 委托的账号名称 最小长度：**0** 最大长度：**256**    |
| trust_domain_id   | String  | 委托的账号id 最小长度：**0** 最大长度：**64** |
| create_time       | String  | 创建时间 最小长度：**0** 最大长度：**32**        |
| expire_time       | String  | 超期时间 最小长度：**0** 最大长度：**32**      |
| valid             | Boolean | 委托是否有效，true：委托未过期 false：委托已过期                                                                   |
   
#### 请求示例
无
#### 响应示例
**状态码： 200**
response of 200
```
{
  "total_count" : 1,
  "agency_list" : [ {
    "id" : "123",
    "name" : "123",
    "duration" : "123",
    "valid" : true,
    "trust_domain_name" : "123",
    "trust_domain_id" : "123",
    "create_time" : "123",
    "expire_time" : "123" 
  } ]
}
```
#### 状态码
| 状态码 | 描述              |
|:---|:---|
| 200 | response of 200 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ticket/ErrorCode.html)。
