重启实例

接口说明


操作实例重启(支持批量),支持同时操作同一地域不同可用区的实例。

注意事项:

  1. 一次最多重启50台实例(RAM用户一次最多10台)。

  2. 实例在active(运行中)状态才能做此操作。

  3. 弹性裸金属不支持硬重启。

  4. 支持选择硬重启,硬重启为强制关闭再启动,可能会导致数据丢失或文件系统损坏,请仅在实例不能正常重启时使用。


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

POST https://ecloud.10086.cn/api/openapi-instance/v4/batch-reboot-instances

请求参数

Body

参数名称
类型
必填
描述
batchRebootReq
BatchRebootReq
是

batchRebootReq

instanceIds
<string> array
是

实例ID数组。可通过查询实例状态列表接口获取。

rebootType
string
否

重启类型。取值范围:

  • SOFT:表示软重启。
  • HARD:表示硬重启。

默认值:SOFT。

请求示例

POST https://ecloud.10086.cn/api/openapi-instance/v4/batch-reboot-instances
{
	"instanceIds":[
		"5e35ed93-c35a-463e-8a6e-840fd8dbe439",
		"aafcf0cd-aced-47bb-b71d-07bd0322dfc6"
	]
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
BatchAction«InstanceActionResult»

请求成功时返回的数据。

instanceBatchResult
<InstanceActionResult> array

实例批量操作结果集。

instanceId
string

实例ID。

result
boolean

操作是否下发成功。

message
string

操作结果信息,失败时返回错误信息,成功时返回空字符串。

errorCode
string

统一错误码。

errorMessage
string

页面国际化错误提示。

errorParams
<string> array

统一错误码的自定义参数。

requestId
string

每个请求的序列号。

state
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)

返回状态码。返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN。

返回示例

返回码:200
OK
{
	"requestId":"reqId-0d77ff54c9f341e9b08ab7df4381cc97-7",
	"state":"OK",
	"body":{
		"instanceBatchResult":[
			{
				"instanceId":"5e35ed93-c35a-463e-8a6e-840fd8dbe439*",
				"result":true,
				"message":""
			},
			{
				"instanceId":"aafcf0cd-aced-47bb-b71d-07bd0322dfc6",
				"result":true,
				"message":""
			}
		]
	}
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。