接口说明
重装实例操作系统（支持批量），支持同时操作不同可用区的实例。
注意事项：
-
最多支持10台实例重装。
-
若填写
size参数，则最多支持1台实例重装，该数值必须大于当前系统盘容量且大于等于目标操作系统所需要的磁盘容量。max[目标镜像磁盘容量，系统盘现有容量]～1024GB。 -
实例没有正在执行的任务，并且状态是
active(运行中)或shutoff（已关机）允许重装主机。 -
password参数：采用RSA对明文加密，用户可用公钥自行加密明文得到密文。明文8-16位字符，同时包括数字、大小写字母和特殊字符，其中不能出现3个及以上连续或重复的数字，如123、111等以及特殊字符最多不能超过3个，且需要在“~ @ # $ % * _ - + = , . ? [ ] { }”范围内。不建议使用包含姓名、电话、出生日期、账号名、系统名以及公司名的密码；不建议使用包含连续的字母、键位或重复的字母、字符的密码，比如abc、asd、@#$、AAA、###等。 -
公钥内容：
-----BEGIN PUBLIC KEY-----
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC/VpRysi0bPRLS7sbgQDJHo1MAt9/bK+nwK5Pe3z0/O4cH5I/8kFNYy4yFsLMM+zyFvVw9C4wzjHaRcmEuF3ziJMC9PD5ufUWgfO5nSGgZW1cmgjqnhcWJ3i+Azj72RnhKQRCn9DgJduEC9MiKfbyTICGd6FXf9cxb21nkxI7vtwIDAQAB
-----END PUBLIC KEY-----
-
如需注入自定义数据，请严格按照自定义数据格式要求传入，详情请参考云主机自定义数据。
-
由于海光芯片与Windows系统存在已知的兼容性差异，使用此组合可能导致性能未达最优或偶发不稳定，如启动阶段蓝屏、系统崩溃等问题。建议您在生产部署业务前充分进行兼容性测试。
URL
POST https://ecloud.10086.cn/api/openapi-instance/v4/batch-rebuild-instances
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
batchRebuildReq
|
BatchRebuildReq
|
是
|
batchRebuildReq |
|
imageId
|
string
|
是
|
镜像ID。可通过查询可重装实例镜像列表接口查看。 |
|
bootVolume
|
BootVolume
|
否
|
系统盘。 |
|
size
|
integer(int32)
|
否
|
系统盘大小，单位为GB。取值范围：
|
|
password
|
string
|
否
|
实例密码。 |
|
keyPairName
|
string
|
否
|
密钥对名称，可通过查询密钥对列表获取。Windows系统请忽略该参数。 |
|
instanceIds
|
<string> array
|
是
|
实例ID数组。可通过查询实例状态列表接口获取。 |
|
userData
|
string
|
否
|
自定义参数，长度在[1,16384]个字符间。您可按照格式要求自行传入UserData信息。
|
请求示例
POST https://ecloud.10086.cn/api/openapi-instance/v4/batch-rebuild-instances{
"instanceIds":[
"c37945d7-0859-4c88-906b-0c49f79b64e0",
"a3e664c3-f3cd-43ee-9f76-32476f218af2"
],
"imageId":"574cdc2d-f96a-4540-bbd1-2e38ca1d6042",
"password":"srzE9jsTwO044EAhipn2gS1fZ9W/5Boi3fb0JME1j3gdFSKZ9u5pPCifzb/9mXQdpnasy/JKV70h5m7fSnLYtF33CMw0n9kqONNlIELUBurfoI9Wtyf0eKFmnDAxqV8UO4T2/BdO1WeF4Um9d9fyBe1OqFCczl15Jfaj9/GI9c=",
"userData":""
}返回参数
|
参数名称
|
类型
|
描述
|
|
body
|
BatchAction«InstanceActionResult»
|
请求成功时返回的数据。 |
|
instanceBatchResult
|
<InstanceActionResult> array
|
实例批量操作结果集。 |
|
instanceOrderAndOrderExtInfos
|
<InstanceOrderAndOrderExtInfo> array
|
批量操作涉及订单返回信息。 |
|
orderExts
|
<OrderExt> array
|
订单项ID数组。 |
|
orderExtType
|
string
|
订单类型。例如：highPerformance(高性能型系统盘)。 |
|
subOrderId
|
string
|
订单项ID。 |
|
orderId
|
string
|
订单ID。 |
|
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。 |
返回示例
{
"requestId":"req-150f330d-2b38-4da8-9113-99992ded4601",
"state":"OK",
"body":{
"instanceBatchResult":[
{
"instanceId":"c37945d7-0859-4c88-906b-0c49f79b64e0",
"result":true,
"message":""
},
{
"instanceId":"a3e664c3-f3cd-43ee-9f76-32476f218af2",
"result":true,
"message":""
}
]
}
}