接口说明
本接口批量操作云主机重装,支持不同可用区云主机批量重装。
一、使用限制
- 最多支持10台云主机重装。
- 若选择 Windows 镜像进行重装,云主机系统盘容量需 ≥ 40 GB,否则将重装失败。
- 当前仅当云主机处于以下状态时允许重装:
- ACTIVE(1)
- SHUTOFF(16)
且主机无正在执行的任务。
二、登录方式与密码规则
您需在 adminPass 和 keypairName 参数中二选一填写,不可同时指定。
若使用 adminPass(密码方式):
- 密码长度为 8–16 位- 必须包含以下四类字符中的三类以上:
- 大写字母
- 小写字母
- 数字
- 特殊字符(限以下范围):~ @ # $ % * _ - + = , . ? [ ] { }(建议最多使用 3 个)
禁止使用以下弱密码模式:
- 连续数字或字母(如:123, abc)
- 重复字符(如:111, AAA, ###)
- 包含姓名、电话、出生日期、公司名、账号名等敏感信息
- 示例合法密码:Ab7@xyLp!
三、密码加密要求(必须)
- adminPass 密码字段必须使用下方 RSA 公钥进行加密,生成密文后再提交。
- 若传入明文或未按规范加密,将导致服务端解密失败,重装操作无法完成。
- 请使用接口返回的公钥进行加密,推荐通过标准加密工具(如 openssl、JavaScript RSA 库等)处理。
- 密钥格式:RSA PKCS#1 公钥(PEM 格式)
公钥内容如下:
-----BEGIN PUBLIC KEY-----
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC/VpRysi0bPRLS7sbgQDJHo1MAt9/bK+nwK5Pe3z0/O4cH5I/8kFNYy4yFsLMM+zyFvVw9C4wzjHaRcmEuF3ziJMC9PD5ufUWgfO5nSGgZW1cmgjqnhcWJ3i+Azj72RnhKQRCn9DgJduEC9MiKfbyTICGd6FXf9cxb21nkxI7vtwIDAQAB
-----END PUBLIC KEY-----
四、其他注意事项 1.由于海光芯片与Windows系统存在已知的兼容性差异,使用此组合可能导致性能未达最优或偶发不稳定,如启动阶段蓝屏、系统崩溃等问题。建议您在生产部署业务前充分进行兼容性测试。
URL
PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/batch/rebuild
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
serverBatchRebuildApiReq
|
ServerBatchRebuildApiReq
|
是
|
批量重装请求体。 |
|
imageId
|
string
|
是
|
镜像ID,可通过查询查询可重装云主机镜像列表接口获取。 |
|
password
|
string
|
否
|
云主机密码。 |
|
serverIds
|
<string> array
|
是
|
云主机ID数组,可通过主机列表详情接口获取。 |
|
userData
|
string
|
否
|
用户自定义数据。 |
请求示例
PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/batch/rebuild
{
"serverIds":[
"c37945d7-0859-4c88-906b-0c49f79b64e0",
"a3e664c3-f3cd-43ee-9f76-32476f218af2"
],
"imageId":"574cdc2d-f96a-4540-bbd1-2e38ca1d6042",
"password":null,
"userData":null
}
返回参数
|
参数名称
|
类型
|
描述
|
|
body
|
ServerBatchActionResp
|
请求成功时返回的数据。 |
|
serverBatchResult
|
<ActionResult> array
|
云主机批量操作结果集。 |
|
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。 |
返回示例
{
"requestId":"req-150f330d-2b38-4da8-9113-99992ded4601",
"state":"OK",
"body":{
"serverBatchResult":[
{
"serverId":"c37945d7-0859-4c88-906b-0c49f79b64e0",
"result":true
},
{
"serverId":"a3e664c3-f3cd-43ee-9f76-32476f218af2",
"result":true
}
]
}
}