云主机重装

POST

/v4/ecs/rebuild-instance

该接口提供用户重装一台云主机功能，通过填写相应云主机ID、镜像ID，您可以调用imageID查看最新的天翼云具体资源池的镜像列表和密码对云主机进行重装。

接口约束

云主机需要处于关机状态。

请求参数

Body 参数application/json

regionID

string

资源池ID

必需

instanceID

string

云主机id

必需

imageID

string

镜像id

可选

password

string

必需

密码，长度在 8- 30之间,含大写字母、小写字母、数字和特殊符号中的至少三项不能以斜线号/开头,支持()`~!@#$%^&*_-+=｜{}[]:;'<>,.? 符号

userData

string

用户自定义数据

可选

示例

{
    "regionID": "TestRegionID",
    "instanceID": "adc614e0-e838-d73f-0618-a6d51d09070a",
    "imageID": "b1d896e1-c977-4fd4-b6c2-5432549977be",
    "password": "rebuildTest123",
    "userData": "UmVidWlsZFRlc3QyMDIyMTEyNDEzMTE="
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v4/ecs/rebuild-instance' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "TestRegionID",
    "instanceID": "adc614e0-e838-d73f-0618-a6d51d09070a",
    "imageID": "b1d896e1-c977-4fd4-b6c2-5432549977be",
    "password": "rebuildTest123",
    "userData": "UmVidWlsZFRlc3QyMDIyMTEyNDEzMTE="
}'

返回响应

🟢200successful operation

application/json

Body

description

string

失败时的错误描述

可选

errorCode

string

具体错误码标志

可选

message

string

失败时的错误信息

可选

returnObj

object

返回参数

可选

jobID

string

任务id

必需

statusCode

integer <int32>

可选

返回状态码(800为成功，900为失败)

示例

{
    "description": "成功",
    "errorCode": "SUCCESS",
    "message": "success",
    "returnObj": {
        "jobID": "58edf427-803b-4d2c-99fd-8298ffec5d96"
    },
    "statusCode": 800
}

修改于 2025-05-26 07:51:25

重启云主机

更新元数据

云主机重装

接口约束#

请求参数

示例代码

返回响应

接口约束