Reinstall OS

POST

https://openapi.lightnode.com/instance/reinstallSystem

API Overview

Reinstalls the operating system of an elastic cloud server, such as Linux or Windows.

The default username is `root` for Linux and `Administrator` for Windows.

This is an asynchronous API. After the reinstall request is accepted, the operation is not completed immediately. Query the task execution status and check `processResult`. When `processResult` is `SUCCESS`, the cloud server has been reinstalled successfully.

Password rules:

8 to 30 characters long

Must include letters and numbers

Must include at least one of the following special characters: ()~!@#$*-+={}[]:;,.?/

Request

Header Params

Body Params application/json

Example

{
    "ecsResourceUUID": "ecs-wr00007bgadt",
    "password": "Pass4433@",
    "imageResourceUUID": "img-rh0000743phm",
    "sshKeyResourceUUID": null,
    "regionCode": "cn-dev-2"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.lightnode.com/instance/reinstallSystem' \
--header 'x-open-token: test-token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ecsResourceUUID": "ecs-wr00007bgadt",
    "password": "Pass4433@",
    "imageResourceUUID": "img-rh0000743phm",
    "sshKeyResourceUUID": null,
    "regionCode": "cn-dev-2"
}'

Responses

🟢202Success

application/json

Bodyapplication/json

Example

{
    "asyncTaskUUID": "7e00007dz0df",
    "httpStatus": 202,
    "rowCount": 0
}

Modified at 2026-04-10 06:08:12

Instance Details

Instance List

Reinstall OS

API Overview#

Reinstalls the operating system of an elastic cloud server, such as Linux or Windows.#

The default username is root for Linux and Administrator for Windows.#

This is an asynchronous API. After the reinstall request is accepted, the operation is not completed immediately. Query the task execution status and check processResult. When processResult is SUCCESS, the cloud server has been reinstalled successfully.#

Password rules:#