升级堡垒机实例 - 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 |
错误码
请参见错误码。
