文档首页> 云数据库 RDS> API参考> API v3（推荐）> 管理数据库和用户（PostgreSQL）> 设置数据库用户权限
更新时间：2024-03-28 GMT+08:00
查看PDF

设置数据库用户权限

功能介绍

设置数据库用户读写权限：只读或可读可写。

接口约束

实例在创建、变更规格、修改端口、冻结、异常等状态下不能执行该操作。

URI

  • URI格式

    POST /v3/{project_id}/instances/{instance_id}/user-privilege

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    是

    租户在某一Region下的项目ID。

    获取方法请参见获取项目ID。

    instance_id

    是

    实例ID。

请求消息

表2 参数说明

名称

是否必选

参数类型

说明

all_users

是

Boolean

是否设置全部数据库用户。

  • true：设置全部数据库用户读写权限，忽略user_name参数。
  • false：单独设置user_name用户读写权限。

user_name

否

String

数据库用户名称。

数据库用户名称在1到63个字符之间，由字母、数字、或下划线组成，不能包含其他特殊字符，不能以“pg”和数字开头，不能和系统用户名称相同。系统用户包括“rdsAdmin”,“ rdsMetric”, “rdsBackup”, “rdsRepl”,“ rdsProxy”, “rdsDdm”。

readonly

是

Boolean

是否为只读权限：

  • true：只读。
  • false：可读可写。

请求示例

  • 设置全部数据库用户只读。
    POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/f569f1358436479dbcba8603c32cc4aein03/user-privilege
{
    "all_users": true,
    "readonly": true
}
  • 设置全部数据库用户可读可写。
    {
    "all_users": true,
    "readonly": false
}
  • 设置单个数据库用户只读。
    {
    "all_users": false,
    "user_name": "test1234",
    "readonly": true
}
  • 设置单个数据库用户可读可写
    {
    "all_users": false,
    "user_name": "test1234",
    "readonly": false
}

响应消息

  • 正常响应要素说明

    无。

状态码

错误码

请参见错误码。