# 获取用户委托列表 - ListUserTrustAgency
#### 功能介绍
获取用户委托给FunctionGraph的委托列表。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-functiongraph/functiongraph_06_0200.html#functiongraph_06_0200)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-functiongraph/functiongraph_06_1100.html#functiongraph_06_1100)。
#### URI
GET /v2/{project_id}/fgs/service-trusted-agencies
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释**: 租户项目 ID，获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-functiongraph/functiongraph_06_0260.html#functiongraph_06_0260)。 **约束限制**: 不涉及。 **取值范围**: 只能由英文字母、数字组成，且长度为32个字符。 **默认取值**: 不涉及。 |
   
表2Query参数 
| 参数     | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| marker | 否    | String | **参数解释**： 本次查询起始位置。 **约束限制**： 只能由数字组成，长度1-64位。 **取值范围**： 不涉及 **默认取值**： '0'         |
| limit  | 否    | String | **参数解释**： 本次查询最大返回的数据条数。 **约束限制**： 只能由数字组成，长度1-64位。 **取值范围**： 不涉及。 **默认取值**： '100' |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释**: 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 **约束限制**: 不涉及。 **取值范围**: 不涉及。 **默认取值**: 不涉及。 |
| Content-Type | 否    | String | **参数解释**: 消息体的类型（格式）。 **约束限制**: 不涉及。 **取值范围**: 只能为application/json **默认取值**: application/json                                                                                        |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数       | 参数类型                                                                                                            | 描述                                                                                                                                                                                                                                                |
|:---|:---|:---|
| \[数组元素\] | Array of [TrustAgencyItem] objects | **参数解释**： 获取用户委托列表返回体。 **取值范围**： 不涉及。 |
   
 表5TrustAgencyItem 
| 参数          | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|
| name        | String | **参数解释**： 委托名称。 **取值范围**： \[0, 64\]                                                                               |
| expire_time | String | **参数解释**： 委托过期时间。"null"表示不过期。 **取值范围**： UTC时间，格式为YYYY-MM-DDTHH:mm:ss.ssssss，日期和时间戳格式如：2023-06-28T08:56:33.710000。 |
   
**状态码：401**
表6响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误信息 |
   
**状态码：403**
表7响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误信息 |
   
**状态码：500**
表8响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误信息 |
   
#### 请求示例
获取用户委托列表。
```
GET /v2/{project_id}/fgs/service-trusted-agencies
```
#### 响应示例
**状态码：200**
ok
```
[ {
  "name" : "fg-agency-a",
  "expire_time" : null
}, {
  "name" : "fg-agency-b",
  "expire_time" : null
}, {
  "name" : "fg-agency-c",
  "expire_time" : null
} ]
```
#### 状态码
| 状态码 | 描述                            |
|:---|:---|
| 200 | ok                            |
| 401 | Unauthorized 鉴权失败。            |
| 403 | Forbidden 没有操作权限。             |
| 500 | Internal Server Error 服务内部错误。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-functiongraph/ErrorCode.html)。