重装云主机系统

接口说明

本接口用于重装指定云主机上的操作系统。
一、使用限制

1. 若选择 Windows 镜像进行重装，云主机系统盘容量需 ≥ 40 GB，否则将重装失败。
2. 当前仅当云主机处于以下状态时允许重装：

• 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系统存在已知的兼容性差异，使用此组合可能导致性能未达最优或偶发不稳定，如启动阶段蓝屏、系统崩溃等问题。建议您在生产部署业务前充分进行兼容性测试。

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

URL

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

请求参数

请求示例

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

{
	"body":{
		"imageId":"bd09fd1c-935d-409d-8439-5e36112ebf87",
		"serverId":"03fd6cc2-b358-49b9-b5f9-1ae2eea8bb4f"
	}
}

返回参数

返回示例

{
	"requestId":"reqId-b25afa58b4453be68956f-272ff4a0-1",
	"state":"OK",
	"body":null
}