创建数据库角色
功能介绍
在指定实例中创建数据库角色。
约束限制
- 实例在创建、变更规格、冻结、异常等状态下不能执行该操作。
- 该接口只支持创建单个角色。
调试
您可以在API Explorer中调试该接口。
URI
POST https://{
Endpoint
}/v3.1/{project_id}/instances/{instance_id}/db-role
表1 参数说明
参数
是否必选
参数类型
描述
project_id
是
String
参数解释：
租户在某一Region下的项目ID。
获取方法请参见获取项目ID。
约束限制：
不涉及。
取值范围：
只能由英文字母、数字组成，且长度为32个字符。
默认取值：
不涉及。
instance_id
是
String
实例ID。
请求参数
表2 参数说明
名称
是否必选
参数类型
说明
name
是
String
数据库角色名称，不可与已有角色名称重复。
数据库角色名称在1到63个字符之间，由字母、数字、或下划线组成，不能包含其他特殊字符，不能以“pg”和数字开头，不能和系统用户/角色名称相同。
系统用户/角色包括“rdsAdmin”,“ rdsMetric”, “rdsBackup”, “rdsRepl”, “root”。
password
是
String
数据库角色密码。
取值范围：非空，密码长度在8到32个字符之间，至少包含大写字母、小写字母、数字、特殊字符~!@#%^*-_=+?,三种字符的组合，不能和数据库账号“name”或“name”的逆序相同。
建议您输入高强度密码，以提高安全性，防止出现密码被暴力破解等安全风险。
响应参数
无。
请求示例
创建一个GaussDB数据库角色，角色名为dbs。
POST https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/instances/{instance_id}/db-role
{
"name" : "dbs",
"password" : "******"
}
响应示例
无。
状态码
-
正常
200
-
异常
请参见状态码。
错误码
请参见错误码。
