功能介绍

给指定实例创建数据库角色。

接口约束

• 该接口只支持DDS社区版。
• 实例在创建、规格变更、修改端口、冻结、重启等过程中以及状态为非“normal”时，不允许执行该操作。

调试

您可以在API Explorer中调试该接口。

URI

• URI格式

  POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/db-role

• URI样例

  https://dds.cn-north-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/659914406d2c4c76bce6a028ce8d8e0din02/db-role

• 参数说明

  表1 参数说明

  名称	是否必选	描述
  project_id	是	租户在某一region下的project ID。
  instance_id	是	实例ID，可以调用“查询实例列表”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

请求消息

• 参数说明

  表2 参数说明

  名称	是否必选	参数类型	描述
  role_name	是	String	创建角色名称。 取值范围：长度为1~64位，可以包含大写字母（A~Z）、小写字母（a~z）、数字（0~9）、中划线、下划线和点。
  roles	否	Array of objects	新建角色所继承的角色列表。请参见表3。
  db_name	否	String	角色所在的数据库名称，默认admin。 取值范围：长度为1~64位，可以包含大写字母（A~Z）、小写字母（a~z）、数字（0~9）、下划线。

  表3 roles字段数据结构说明

  名称	是否必选	参数类型	描述
  role_db_name	是	String	被继承角色所在数据库名称。 取值范围：长度为1~64位，可以包含大写字母（A~Z）、小写字母（a~z）、数字（0~9）、下划线。
  role_name	是	String	被继承角色的名称。 取值范围：长度为1~64位，可以包含大写字母（A~Z）、小写字母（a~z）、数字（0~9）、中划线、下划线和点。

• 请求体样例

  {
      "role_name": "testRole",
      "roles" : [{
          "role_name":"readWrite",
          "role_db_name":"testDb" 
      }],
      "db_name":"testDb" 
  }

响应消息

• 响应样例

  {}

状态码

详情请参见状态码。

错误码

详情请参见错误码。