发布 Agent 版本
发布 Agent 版本
支持将指定 Agent 版本发布为线上生产版本。
该接口使用目标 Agent 自身的 API Key 鉴权，只允许开启版本管理权限的 Agent 调用。
请求方式
POST
调用地址
https://api.${endpoint}/v1/agent/version/release
调用验证
详情参见 API 概述的鉴权方式说明。请使用目标 Agent 的 API Key 作为 token。
请求
请求示例
curl -X POST 'https://api.${endpoint}/v1/agent/version/release' \
-H 'Authorization: Bearer ${token}' \
-H 'Content-Type: application/json' \
-d '{
"version": "v2"
}'
curl -X POST 'https://api.${endpoint}/v1/agent/version/release' \
-H 'Authorization: Bearer ${token}' \
-H 'Content-Type: application/json' \
-d '{
"version": "v2"
}'
此代码块在浮窗中显示
请求头
| 字段 | 类型 | 说明 |
|---|---|---|
| Authorization | Bearer ${token} | 使用目标 Agent 的 API Key 进行调用验证。 |
| Content-Type | application/json | 请求体格式。 |
请求参数（Body Parameters）
| 参数 | 类型 | 说明 | required |
|---|---|---|---|
| version | String | 要发布为线上的版本号。 | true |
响应
响应体
{
"code": 0,
"message": "OK",
"data": {
"version": "v2",
"previous_version": "v1"
}
}
{
"code": 0,
"message": "OK",
"data": {
"version": "v2",
"previous_version": "v1"
}
}
此代码块在浮窗中显示
成功响应
| 字段 | 类型 | 说明 |
|---|---|---|
| version | String | 本次发布的版本号。 |
| previous_version | String | 发布前的线上版本号；首次发布为空。 |
失败响应
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 错误码。 |
| message | string | 错误信息。 |
状态码
| 状态码 | 说明 |
|---|---|
| 200 | 成功 |
| 400 | 参数错误 |
| 401 | 未授权 |
| 403 | 权限不足或 API Key 未开启版本管理权限 |
| 429 | 请求过于频繁 |
| 500 | 服务器错误 |