Creating a Database Account

Function

This API is used to create a database account for a specified DB instance.

Before calling this API, learn how to authenticate it.
Before calling this API, learn about request header parameters.

Constraints

This operation cannot be performed when the DB instance is in any of the following statuses: creating, changing instance class, changing port, frozen, or abnormal.
If you want to call this API repeatedly to create database accounts for your DB instance, call it in serial.

URI

URI format
POST /v3/{project_id}/instances/{instance_id}/db_user

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 The username contains 1 to 63 characters, including letters, digits, and underscores (_). It cannot start with pg or a digit and must be different from system usernames. System users include rdsAdmin, rdsMetric, rdsBackup, rdsRepl, rdsProxy, and rdsDdm. Default Value N/A
password	Yes	String	Definition Specifies the password of the database account. Constraints N/A Range 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 (~!@#%^-_=+?,). 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

Creating a database account named rds

POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/f569f1358436479dbcba8603c32cc4aein03/db_user

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