GetWorkloadAccessToken
更新时间：2026-07-14
GetWorkloadAccessToken
- 为指定 Agent 获取 Workload Access Token（WAT），用于后续获取凭证。适用于 agent 没有用户的场景。有效期内重复请求返回缓存中的同一 Token（Redis 缓存 15 分钟）。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/agent-identity/workload-access-token HTTP/1.1
2Host: identity.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| bceUserId | String | 否 | RequestBody参数 | BCE 用户 ID（服务号调用时必填，用户身份调用不传，系统自动解析覆盖） |
| agentId | String | 否 | RequestBody参数 | （二选一，优先使用）Agent ID，优先使用 ID，存在则不看 name |
| agentName | String | 否 | RequestBody参数 | （二选一）Agent 名称 |
| durationSeconds | Integer | 否 | RequestBody参数 | 有效期（秒），默认 3600，最小 900，最大 86400 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| token | String | WAT 令牌（格式：wat-v1. |
| expireAt | DateTime | 过期时间（ISO 8601） |
请求示例
Plain Text
1{
2 "agentId": "ag-xxxxxxxxxx",
3 "durationSeconds": 3600
4}返回示例
Plain Text
1{
2 "token": "wat-v1.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
3 "expireAt": "2025-01-01T01:00:00Z"
4}评价此篇文章