接口功能介绍
修改数据库用户拥有的分组。
接口约束
请先订购实例。请先创建数据库用户。注意默认分组不要从用户权限里移除,否则可能导致用户无法连接分组下的节点。
URI
PUT /v2/user/alter-groups
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
prodInstId | 是 | String | 产品实例id | ||
name | 是 | String | 数据库用户名称 | user1 | |
groups | 是 | Array of Strings | 分组名列表。修改后,用户拥有的分组就是该列表里面的值。此处若填空的列表,表示删除所有拥有的分组。不允许传null。注意:公有云只有一个分组(默认分组),且用户必须有该分组权限。因此,本参数在公有云场景,都会设置为默认分组。 |
响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
code | 是 | String | 返回码 取值范围:0表示成功,1表示失败 | 0 | |
message | 是 | String | 结果描述 | success |
请求示例
请求头header
无
请求体body
{
"prodInstId": "cb236d462b924ef7bfba5ecf1d61de2b",
"name": "user1",
"groups":[
"默认分组"
]
}
响应示例
{
"code": 0,
"message": "success"
}
状态码
请参考 状态码说明。