升级堡垒机实例 - UpgradeInstance
功能介绍
升级云堡垒机实例。
调用方法
请参见如何调用API。
URI
POST /v2/{project_id}/cbs/instance/upgrade
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID。 获取方法请参见获取项目ID。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 获取方法请参见获取用户Token。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| server_id | 是 | String | 实例id |
| upgrade_time | 是 | Long | 定时升级的时间，需要比当前时间大24小时 |
| cancel | 否 | Boolean | 是否取消升级定时任务，已开始任务不可取消。
|
响应参数
状态码：200
Upgrade Cbh Instance Success
状态码：400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_description | String | 请求参数错误。 |
状态码：401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_description | String | 校验TOKEN失败。 |
状态码：403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_description | String | 已是最新版本不需要升级/agent未启动。 |
状态码：404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_description | String | 没有找到CBH资源。 |
请求示例
{
"server_id" : "c7277d87-5a0d-4cfc-a418-97acb567cf29",
"upgrade_time" : 1702974655000
} 响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 200 | Upgrade Cbh Instance Success |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | 已是最新版本不需要升级/agent未启动 |
| 404 | Not Found |
错误码
请参见错误码。
