Changing Password of a Database User

This API is used to change the password of a database user. Before calling this API:

PUT /v3/{project_id}/instances/{instance_id}/db-users/password

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition: Project ID of a tenant in a region. To obtain this value, see Obtaining a Project ID. Constraints: N/A Range: The value can contain 32 characters. Only letters and digits are allowed. Default value: N/A
instance_id	Yes	String	Definition: Instance ID, which uniquely identifies an instance. Constraints: N/A Range: The value can contain 36 characters with a suffix of in07. Only letters and digits are allowed. Default value: N/A

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition: User token. To obtain this value, call the IAM API for obtaining a user token. The value of X-Subject-Token in the response header is the token value. Constraints: N/A Range: N/A Default value: N/A
X-Language	No	String	Definition: Request language type. Constraints: N/A Range: en-us zh-cn Default value: en-us

**Table 3** Request body parameter
Parameter	Mandatory	Type	Description
users	Yes	Array of ResetDatabasePassword objects	Definition: List of database users whose passwords are to be changed. Constraints: The list can contain a maximum of 50 database users.

**Table 4** ResetDatabasePassword
Parameter	Mandatory	Type	Description
name	Yes	String	Definition: Database username. Constraints: N/A Range: The username can consist of 1 to 32 characters. Only letters, digits, and underscores (_) are allowed. Default value: N/A
host	Yes	String	Definition: Host IP address. Constraints: To specify multiple IP addresses, separate them with commas (,), for example, 192.168.0.1,172.16.213.9 (no spaces before or after the comma). Range: %: All IP addresses can access your TaurusDB instance. You can use % to wildcard some IP addresses. For example, if you enter 10.10.10.%, all IP addresses in the subnet 10.10.10.X can access the TaurusDB instance. Default value: N/A
password	Yes	String	Definition: Password of the database user. Constraints: You are advised to enter a strong password to improve security and prevent security risks such as brute force cracking. Range: The value cannot be empty. It can consist of 8 to 32 characters and must contain at least three types of the following: uppercase letters, lowercase letters, digits, and special characters \|.~!@#$%^-_=+?,()& Default value*: N/A

Status code: 202

**Table 5** Response body parameter
Parameter	Type	Description
job_id	String	Definition: ID of the task for changing the passwords of database users. Range: N/A

Status code: 400

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Status code: 500

**Table 7** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Changing password of database user gaussdb_mysql_user1

{
  "users" : [ {
    "name" : "gaussdb_mysql_user1",
    "host" : "127.0.0.1",
    "password" : "Rds_1234"
  } ]
}

Status code: 202

Success.

{
  "job_id" : "dff1d289-4d03-4942-8b9f-463ea07c000d"
}

For details, see Status Codes.

For details, see Error Codes.

Parent topic: Database User Management

Thank you very much for your feedback. We will continue working to improve the documentation.

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