云主机批量开机

接口说明

本接口用于批量操作同一可用区下云主机开机,一次最多开机50台云主机(RAM用户一次最多10台)。云主机在关机或已停止状态才能做此操作,如果云主机存在状态为创建中、重启中、规格变更中、业务暂停、重装镜像中、密钥对更新中、云硬盘挂载中、云硬盘卸载中等中间状态,不支持此操作。


推荐使用API Explorer调试

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

URL

PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/batch/start

请求参数

Body

参数名称
类型
必填
描述
serverBatchReq
ServerBatchReq
是

云主机批量开机请求体。

serverIds
<string> array
是

主机ID组成的数组,可通过主机列表详情接口获取。

请求示例

PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/batch/start
{
	"serverIds":[
		"6a67d90c-4dc1-444f-8c18-c1eb97a1536e",
		"928eddf3-00eb-4c09-aaea-anld3b513d4f"
	]
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
ServerBatchActionResp

请求成功时返回的数据

serverBatchResult
<ActionResult> array

云主机批量操作结果集

message
string

操作结果信息,失败时返回错误信息,成功时返回success

result
boolean

操作是否下发成功

serverId
string

云主机ID

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-****-8e359238-7",
	"state":"OK",
	"body":{
		"serverBatchResult":[
			{
				"serverId":"fa42141d-eb0d-4915-bef0-****",
				"result":true,
				"message":"success"
			},
			{
				"serverId":"928eddf3-00eb-4c09-aaea-****",
				"result":true,
				"message":"success"
			}
		]
	}
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。