Resetting the Password for Logging In to an ECS with a Few Clicks

This API is used to reset the password of the ECS management account, root or Administrator.

There is no password complexity check that meets security requirements. No error message is displayed after an insecure password is entered.
Before using this API, you must install the password reset plug-in. For instructions about how to download and install the password reset plug-in, see "Installing the One-Click Password Reset Plug-in on an ECS" in Elastic Cloud Server User Guide.
This API cannot detect whether the target ECS supports password reset.
If resetting the password for logging in to an ECS failed, this API will not report an error.
A new password takes effect after the ECS is started or restarted.
This API allows you to reset passwords when the target ECSs are running or stopped.

PUT /v2.1/{project_id}/servers/{server_id}/os-reset-password

Table 1 describes the parameters in the URI.

**Table 1** Parameter description
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.

Table 2 describes the request parameters.

**Table 2** Request parameters
Parameter	Type	Mandatory	Description
reset-password	Object	Yes	Specifies the reset-password details. For details, see Table 3.

**Table 3** **reset-password** field description
Parameter	Type	Mandatory	Description
new_password	String	Yes	Specifies the new password for logging in to the ECS. This API does not check password security. Ensure that the password complexity complies with the password rules. The password rules are as follows: Consists of 8 to 26 characters. Must contain at least three of the following character types: Uppercase letters Lowercase letters Digits Special characters, including !@$%^-_=+[{}]:,./? Cannot contain the username or the username in reverse. Cannot contain more than two characters in the same sequence as they appear in the username. (This requirement applies only to Windows ECSs.)

None

The password in the request is used as an example. Do not copy it for use.

PUT https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-reset-password

{
	"reset-password": {
		"new_password": "YNbUwp!dUc9MClnv"
	}
}

None

Parent topic: Password Management

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.