Updated on 2025-08-20 GMT+08:00

Resetting a Password for a Database Account

Function

This API is used to reset a password for a database account.

Constraints

The password of a database account cannot be reset if the DB instance is in any of the following statuses: creating, changing instance class, changing port, rebooting, frozen, or abnormal.

URI

  • URI format

    POST /v3/{project_id}/instances/{instance_id}/db_user/resetpwd

  • Parameter description
    Table 1 Parameters

    Parameter

    Mandatory

    Description

    project_id

    Yes

    Definition

    Project ID of a tenant in a region.

    To obtain the value, see Obtaining a Project ID.

    Constraints

    N/A

    Range

    N/A

    Default Value

    N/A

    instance_id

    Yes

    Definition

    Instance ID.

    Constraints

    N/A

    Range

    N/A

    Default Value

    N/A

Request

Table 2 Parameters

Parameter

Mandatory

Type

Description

name

Yes

String

Definition

Specifies the username of the database account.

Constraints

N/A

Range

N/A

Default Value

N/A

password

Yes

String

Definition

Specifies the password of the database account.

Constraints

N/A

Range

The parameter 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 (~!@#%^*-_=+?,). The value cannot contain the username or the username spelled backwards.

You are advised to enter a strong password to improve security, preventing security risks such as brute force cracking.

Default Value

N/A

Example Request

Reset the password of rds.
POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/f569f1358436479dbcba8603c32cc4aein03/db_user/resetpwd

{
    "name": "rds",
    "password": "****"
}

Response

  • Normal response
    Table 3 Parameters

    Parameter

    Type

    Description

    resp

    String

    Definition

    Calling result.

    Range

    Returns successful if the calling is successful.

Status Code

Error Code

For details, see Error Codes.