更新时间:2023-11-24 GMT+08:00

创建数据库角色

接口说明

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

约束说明

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

URI

  • URI格式

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

  • URI样例

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

表1 请求参数

名称

类型

IN

是否必选

描述

X-Auth-Token

string

header

从IAM服务获取的用户Token。请参考认证鉴权

project_id

string

path

租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。

instance_id

string

path

实例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)、中划线、下划线和点。

请求示例

创建指定实例的数据库角色testRole。
{
    "role_name": "testRole",
    "roles" : [{
        "role_name":"readWrite",
        "role_db_name":"testDb" 
    }],
    "db_name":"testDb" 
}

响应消息

  • 响应示例
    {}

SDK

单击文档数据库服务 DDS SDK,下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。

状态码

详情请参见状态码

错误码

详情请参见错误码