授权数据库帐号

功能介绍

在指定实例的数据库中, 设置帐号的权限。

• 调用接口前，您需要了解API 认证鉴权。
• 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

接口约束

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

URI

• URI格式

  POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/db_privilege

• URI样例

  https://rds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/db_privilege

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一region下的project ID。 获取方法请参见获取项目ID。
  instance_id	是	实例ID。

请求消息

• 参数说明

  表2 参数说明

  名称	是否必选	参数类型	说明
  db_name	是	String	数据库名称。
  users	是	Array of objects	每个元素都是与数据库相关联的帐号。单次请求最多支持50个元素。 每个元素结构请参见表3。

  表3 users列表元素数据结构说明

  名称	是否必选	参数类型	说明
  name	是	String	数据库帐号名称。 数据库帐号名称在1到128个字符之间，不能和系统用户名称相同。 系统用户包括：rdsadmin, rdsuser, rdsbackup, rdsmirror。

• 请求样例

  {
      "db_name": "rds-test",
      "users": [
          {
              "name": "rds"
          },
          {
              "name": "rds001"
          }
      ]
  }

响应消息

• 正常响应要素说明

  表4 要素说明

  名称	参数类型	说明
  resp	String	调用正常时，返回“successful”。

• 正常响应样例

  {
      "resp": "successful"
  }

• 异常响应

  请参见异常请求结果。

状态码

请参见状态码。

错误码

请参见错误码。