# 获取委托凭证 - GetAgencyCredentials
#### 功能介绍
获取分配给用户的委托或信任委托的STS短期凭证。
#### URI
GET /v1/credentials
表1Query参数 
| 参数                | 是否必选 | 参数类型   | 描述                   |
|:---|:---|:---|:---|
| target_account_id | 是    | String | 目标账号的全局唯一标识符（ID）。    |
| agency_urn        | 是    | String | 委托或信任委托的统一资源名称（URN）。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                     |
|:---|:---|:---|:---|
| access-token | 是    | String | 创建令牌接口调用签发的访问令牌。 最大长度：**4096** |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数                                                                                                   | 参数类型   | 描述                   |
|:---|:---|:---|
| [agency_credentials] | Object | 分配给用户在指定委托或信任委托下的凭证。 |
   
 表4agency_credentials 
| 参数                | 参数类型   | 描述            |
|:---|:---|:---|
| access_key_id     | String | 用于临时安全凭证的标识符。 |
| expiration        | Long   | 临时安全凭证到期的日期。  |
| secret_access_key | String | 用于对请求进行签名的密钥。 |
| session_token     | String | 用于临时凭证的令牌。    |
   
#### 请求示例
获取分配给用户的委托或信任委托的STS短期凭证。
```
GET https://{hostname}/v1/credentials
```
#### 响应示例
**状态码： 200**
Successful
```
{
  "agency_credentials" : {
    "access_key_id" : "example-access-key-id",
    "expiration" : 1684955360,
    "secret_access_key" : "example-secret-access-key",
    "session_token" : "string"
  }
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-identitycenter/iic_04_0030.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-identitycenter/ErrorCode.html)。