实例重启 - BatchRebootInstance
功能介绍
调用此接口可以批量重启云机实例。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
POST /v1/instances/reboot
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
x-request-id |
是 |
String |
消息跟踪唯一id |
|
X-Auth-Token |
是 |
String |
租户级Token |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
instance_ids |
是 |
Array of strings |
实例列表,最大长度100列 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
响应码,错误码规范KooPhone.API.1001,数字递增 |
|
error_msg |
String |
响应描述 |
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
0:成功 KOOPHONE.API.1000:请求参数错误 KOOPHONE.API.1001:没有实例权限 KOOPHONE.API.5005:不是所有的实例都在运行中状态 KOOPHONE.API.9999:服务内部报错 |
|
error_msg |
String |
错误信息 |
状态码:500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
0:成功 KOOPHONE.API.1000:请求参数错误 KOOPHONE.API.1001:没有实例权限 KOOPHONE.API.5005:不是所有的实例都在运行中状态 KOOPHONE.API.9999:服务内部报错 |
|
error_msg |
String |
错误信息 |
请求示例
/v1/instances/reboot
{
"instance_ids" : [ "a44uhlf7" ]
}
响应示例
状态码:200
实例重启响应
{
"error_code" : "0",
"error_msg" : "OK"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
实例重启响应 |
|
400 |
请求错误 |
|
500 |
内部错误 |
错误码
请参见错误码。