# 创建用户个人的临时访问令牌 - CreateUsersImpersonationBearerToken
#### 功能介绍
创建用户个人的临时访问令牌
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CodeArtsRepo/doc?api=CreateUsersImpersonationBearerToken&version=v4)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
POST /v4/users/impersonation-bearer-tokens
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 不涉及。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 不涉及。 |
   
表2请求Body参数 
| 参数          | 是否必选 | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| name        | 是    | String           | **参数解释：** 令牌名称。 **取值范围：** 字符串长度不少于1，不超过1000。                                                                                                                                                                     |
| duration    | 否    | Integer          | **参数解释：** 令牌有效时长,单位为秒，会从当前时间开始计算。 **取值范围：** \[900s, 86400s\]，如果不传时默认86400。 **取值范围：** 1\~2147483647 |
| scopes      | 否    | Array of strings | **参数解释：** 令牌权限点。 **取值范围：** \[download,push\],如果要有下载推送权限需要同时配置。                                                                                                                                                   |
| description | 否    | String           | **参数解释：** 令牌的描述。 **取值范围：** 字符串长度不少于1，不超过1000。                                                                                                                                                                    |
   
#### 响应参数
**状态码：201**
表3响应Body参数 
| 参数            | 参数类型    | 描述                                                                                                                                                                                                                  |
|:---|:---|:---|
| id            | String  | **参数解释：** 令牌id。 **取值范围：** 字符串长度不少于1，不超过1000。   |
| name          | String  | **参数解释：** 令牌名称。 **取值范围：** 字符串长度不少于1，不超过1000。   |
| revoked       | Boolean | **参数解释：** 令牌是否失效。                                                                                                                                            |
| created_at    | String  | **参数解释：** 令牌创建时间。 **取值范围：** 字符串长度不少于1，不超过1000。 |
| scopes        | String  | **参数解释：** 令牌权限点。 **取值范围：** 字符串长度不少于1，不超过1000。  |
| active        | Boolean | **参数解释：** 令牌是否有效。                                                                                                                                            |
| expires_at    | String  | **参数解释：** 过期时间。 **取值范围：** 字符串长度不少于1，不超过1000。   |
| impersonation | Boolean | **参数解释：** 是否为个人token。                                                                                                                                        |
| token         | String  | **参数解释：** 令牌。 **取值范围：** 字符串长度不少于1，不超过1000。     |
| description   | String  | **参数解释：** 令牌描述。 **取值范围：** 字符串长度不少于1，不超过1000。   |
   
**状态码：401**
表4响应Body参数 
| 参数         | 参数类型   | 描述                                                                     |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。  |
| error_msg  | String | **参数解释：** 错误信息。 |
   
#### 请求示例
```
POST https://{endpoint}/v4/users/impersonation-bearer-tokens
{
  "name" : 213,
  "scopes" : [ "download", "push" ],
  "duration" : 233,
  "description" : 2123
}
```
#### 响应示例
**状态码：201**
OK
```
{
  "id" : 95022,
  "name" : 213,
  "revoked" : false,
  "created_at" : "Wed Jun 03 03:21:09 CST 2026",
  "scopes" : "---\\n- download\\n- push\\n",
  "active" : true,
  "expires_at" : "Fri Jul 03 00:00:00 CST 2026",
  "impersonation" : true,
  "token" : "VWkkHjk_XdczQyxAuNQ5CzxW"
}
```
**状态码：401**
Unauthorized
```
{
  "error_code" : "DEV.00000003",
  "error_msg" : "认证信息过期"
}
```
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 201 | OK           |
| 401 | Unauthorized |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-codeartsrepo/ErrorCode.html)。