Reinstalling an ECS OS (Using an Image Without Cloud-Init Installed)
Function
This API is used to reinstall an ECS OS.
After this API is called, the system uninstalls the system disk, uses the original image to create a system disk, and attaches it to the ECS. In this way, the OS is reinstalled.
This API supports the images without Cloud-Init or Cloudbase-Init installed. Otherwise, use the API described in Reinstalling an ECS OS (Using an Image with Cloud-Init Installed).
Constraints
- You can reinstall OS only on an ECS that is stopped or for which OS reinstallation has failed.
- You cannot reinstall OS on an ECS that does not have the system disk.
- You are not allowed to perform other operations when reinstalling the OS. Otherwise, reinstalling the OS will fail.
URI
POST /v1/{project_id}/cloudservers/{server_id}/reinstallos
Table 1 describes the parameters in the URI.
Parameter | Mandatory | Description |
---|---|---|
project_id | Yes | Specifies the project ID. For details about how to obtain the ID, see Obtaining a Project ID. |
server_id | Yes | Specifies the ECS ID. |
Request
Table 2 describes the request parameters.
Parameter | Mandatory | Type | Description |
---|---|---|---|
os-reinstall | Yes | Object | Reinstall the ECS. For details, see Table 3. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
adminpass | No | String | Specifies the initial password of the ECS administrator. The Windows administrator username is Administrator, and the Linux administrator username is root. Password complexity requirements:
NOTE:
|
keyname | No | String | Specifies the key name. |
userid | No | String | Specifies the user ID. |
Response
For details, see Responses (Task).
Example Request
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/reinstallos
{"os-reinstall": {"keyname": "KeyPair-350b","userid": "7e25b1da389f4697a79df3a0e5bd494e"}}
Example Response
See Responses (Task).
Returned Values
Error Codes
See Error Codes.
- Function
- Constraints
- URI
- Request
- Response
- Example Request
- Example Response
- Returned Values
- Error Codes