doc-exports/docs/rds/api-ref/rds_05_0011.html

Resetting the Password for User Root

Function

This API is used to reset the password if you forget the password of your database account when using RDS. If an error occurs on the root account, for example, the root account is lost or deleted, you can restore the root account rights through resetting the password.

• Before calling an API, you need to understand the API in Authentication.
• Before calling this API, obtain the required region and endpoint.

Constraints

The password cannot be reset if the DB instance is in any of the following statuses: creating, rebooting, upgrading, changing instance class, creating users, or deleting users.

URI

• URI format

  POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/password

• Parameter description

  Table 1 URI Parameters

  Name	Mandatory	Description
  project_id	Yes	Specifies the project ID of a tenant in a region. For details about how to obtain the project ID, see Obtaining a Project ID.
  instance_id	Yes	Specifies the DB instance ID.

Request

• Parameter description

  Table 2 Request header parameters

  Parameter	Mandatory	Type	Description
  Content-Type	Yes	String	The content type. The default value is application/json.
  X-Auth-Token	Yes	String	Specifies the user token. The user token is a response to the API used to obtain a user token.

  Table 3 Request body parameters

  Name	Mandatory	Type	Description
  db_user_pwd	Yes	String	Specifies the database password. Valid value (for all RDS engines): The value must be 8 to 32 characters long and contain at least three types of the following characters: uppercase letters, lowercase letters, digits, and special characters (``~!@#$%^*-_=+?,()&``). NOTICE: You are advised to enter a strong password to improve security, preventing security risks such as brute force cracking.

Example Request

Reset the password for user root.

POST https://rds.eu-de.otc.t-systems.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/password

{
     "db_user_pwd": "******"
}

Response

• Normal response

  None

• Example normal response

  {}

• Abnormal response

  For details, see Abnormal Request Results.

Status Code

• Normal

  200

• Abnormal

  For details, see Status Codes.

Error Code

For details, see Error Codes.

Parent topic: Database Security