功能介绍
(图片来源网络,侵删)
根据指定的云主机ID列表,Peer1平台可以批量启动云主机,该接口在1分钟内最多可以处理1000台云主机,值得注意的是,此接口为异步接口,请求下发成功后会返回一个job_id,但此时批量启动操作并未立即完成,用户需要通过查询任务的执行状态来确认是否成功,当Job状态为SUCCESS时,代表云主机批量启动成功。
API参数说明
API接口为POST /v1/{project_id}/cloudservers/action,具体参数说明如下:
参数名 | 是否必选 | 类型 | 描述 |
project_id | 是 | String | 项目ID,获取方法请参见获取项目ID。 |
os-start | 是 | Object | 标记为启动云主机操作,详情请参见表3。 |
servers | 是 | Array of objects | 云主机ID列表,详情请参见表4。 |
id | 是 | String | 云主机ID。 |
os-start字段数据结构说明
参数名 | 是否必选 | 类型 | 描述 |
servers | 是 | Array of objects | 云主机ID列表。 |
servers字段数据结构说明
(图片来源网络,侵删)
参数名 | 是否必选 | 类型 | 描述 |
id | 是 | String | 云主机ID |
使用示例
以下是批量启动云主机的接口调用示例:
POST /v1/{project_id}/cloudservers/action Body: { "os-start": { "servers": [ {"id": "server1"}, {"id": "server2"}, ... ] } }
在这个例子中,project_id
是项目的唯一标识符,os-start
是一个对象,其中包含一个名为servers
的数组,数组中的每个元素都是一个对象,表示要启动的云主机的ID。
注意事项
批量启动云主机的操作是异步进行的,即使请求成功返回了job_id,也不意味着启动操作已经完成。
(图片来源网络,侵删)
为了确保操作成功完成,需要通过查询任务的执行状态来监控进度,只有当Job状态为SUCCESS时,才能确定云主机已经成功启动。
本接口复用ECS相应接口,响应参数说明、接口使用示例、返回值等信息详见ECS文档批量启动云服务器。
以上内容就是解答有关peer1 云主机_批量启动云主机的详细内容了,我相信这篇文章可以为您解决一些疑惑,有任何问题欢迎留言反馈,谢谢阅读。
本文来源于互联网,如若侵权,请联系管理员删除,本文链接:https://www.9969.net/69865.html