云服务器内容精选

  • 响应参数 表2 参数说明 参数 参数类型 描述 users Array of objects 列表中每个元素表示一个数据库用户,详情参见表3。 total_count Integer 数据库用户总数。 表3 users字段数据结构说明 参数 参数类型 描述 name String 用户名称。 attribute Object 用户的权限属性,详情参见表4。 memberof String 用户的默认权限。 lock_status Boolean 用户是否被锁,取值为“true”或“false”。 表4 attribute字段数据结构说明 参数 参数类型 描述 rolsuper Boolean 用户是否具有管理员权限,取值为“true”或“false”。 rolinherit Boolean 用户是否自动继承其所属角色的权限,取值为“true”或“false”。 rolcreaterole Boolean 用户是否支持创建其他子用户,取值为“true”或“false”。 rolcreatedb Boolean 用户是否可以创建数据库,取值为“true”或“false”。 rolcanlogin Boolean 用户是否可以登录数据库,取值为“true”或“false”。 rolconnlimit Integer 用户连接实例的最大并发连接数。-1表示没有限制。 rolreplication Boolean 用户是否属于复制角色,取值为“true”或“false”。 rolbypassrls Boolean 用户是否绕过每个行级安全策略,取值为“true”或“false”。 rolpassworddeadline String 用户密码过期时间。
  • 响应示例 查询数据库用户列表成功。 { "users": [ { "name": "root", "attributes": { "rolsuper": false, "rolinherit": true, "rolcreaterole": true, "rolcreatedb": true, "rolcanlogin": true, "rolconnlimit": -1, "rolreplication": false, "rolbypassrls": false, "rolpassworddeadline": "" }, "memberof": "{gs_role_copy_files,gs_role_signal_backend,gs_role_tablespace,gs_role_replication,gs_role_account_lock}", "lock_status": false } ], "total_count": 1 }
  • URI GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/db-users 表1 参数说明 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 instance_id 是 String 实例ID。 offset 否 Integer 分页符。从第一条数据偏移offset页数据后开始查询,默认为0(偏移0页数据,表示从第一条数据开始查询),必须为数字,不能为负数。例如:该参数指定为1,limit指定为10,则只展示第11-20条数据。 limit 否 Integer 每页显示的条目数量,取值范围[1, 100],默认10。
  • URI GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/databases 表1 参数说明 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 instance_id 是 String 实例ID。 offset 否 Integer 分页符。从第一条数据偏移offset页数据后开始查询,默认为0(偏移0页数据,表示从第一条数据开始查询),必须为数字,不能为负数。例如:该参数指定为1,limit指定为10,则只展示第11~20条数据。 limit 否 Integer 每页显示的条目数量,取值范围[1, 100],默认10。
  • 响应示例 查询数据库列表成功。 { "databases": [ { "name": "gaussdb_test", "owner": "root", "size": "25 MB", "datctype": "en_US.UTF-8", "character_set": "UTF8", "collate_set": "en_US.UTF-8", "compatibility_type": "GaussDB" }, { "name": "gaussdb_test1", "owner": "root", "size": "25 MB", "datctype": "en_US.UTF-8", "character_set": "UTF8", "collate_set": "en_US.UTF-8", "compatibility_type": "GaussDB" }, { "name": "gaussdb_test2", "owner": "root", "size": "25 MB", "datctype": "en_US.UTF-8", "character_set": "UTF8", "collate_set": "en_US.UTF-8", "compatibility_type": "GaussDB" } ], "total_count": 3 }
  • 响应参数 表2 参数说明 参数 参数类型 描述 databases Array of objects 列表中每个元素表示一个数据库。详情参见表3。 total_count Integer 总记录数。 表3 databases字段数据结构说明 参数 参数类型 描述 name String 数据库名称。 owner String 数据库所属用户。 character_set String 数据库使用的字符集,例如UTF8。 collate_set String 数据库排序集,例如en_US.UTF-8等。 size String 数据库大小。 datctype String 数据库使用的字符分类,例如en_US.UTF-8等。 compatibility_type String 数据库兼容的类型,如GaussDB,M。
  • 响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 databases Array of objects 列表中每个元素表示一个数据库。 详情请参见表3。 total_count Integer 数据库总数。 表3 databases元素结构说明 名称 参数类型 说明 name String 数据库名称。 owner String 数据库所属用户。 character_set String 数据库使用的字符集,例如UTF8。 collate_set String 数据库排序集,例如en_US.UTF-8等。 size Integer 数据库大小(单位:字节)。 comment String 数据库备注。 正常响应样例 { "databases": [ { "name": "rds_test", "owner": "root", "character_set": "UTF8", "collate_set":"en_US.UTF-8", "size":10777247, "comment":"comment" }, { "name": "rds_test2", "owner":"root", "character_set": "UTF8", "collate_set":"en_US.UTF-8", "size":1055623, "comment":"comment" }, { "name": "rds_test3", "owner":"root", "character_set": "UTF8", "collate_set":"en_US.UTF-8", "size":107772488, "comment":"comment" } ], "total_count": 3 } 异常响应 请参见异常请求结果。
  • 请求示例 设置gaussdb_test数据库多个账号的权限。 { "db_name" : "gaussdb_test", "users" : [ { "name" : "rds", "readonly" : false, "schema_name" : "teste123" }, { "name" : "rds001", "readonly" : true, "schema_name" : "teste134" }, { "name" : "rds002", "readonly" : false, "schema_name" : "teste135" } ] }
  • 请求示例 DELETE https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/a8abe84a41364097be7c233c39275087in04/db_privilege { "db_name": "rds-test", "users": [ { "name": "rds" }, { "name": "rds001" } ] }
  • 请求消息 参数说明 表2 参数说明 名称 是否必选 参数类型 说明 db_name 是 String 数据库名称。 users 是 Array of objects 每个元素是与数据库相关联的账号。单次请求最多支持50个元素。 每个元素结构请参见表3。 表3 users列表元素数据结构说明 名称 是否必选 参数类型 说明 name 是 String 数据库账号名称。 数据库账号名称在1到128个字符之间,不能和系统用户名称相同。 系统用户包括:rdsadmin, rdsuser, rdsbackup, rdsmirror。
  • 请求消息 参数说明 表2 参数说明 名称 是否必选 参数类型 说明 name 是 String 数据库账号名称。 password 是 String 数据库账号密码。 取值范围: 非空,至少包含以下字符中的三种:大写字母、小写字母、数字和特殊符号~!@#%^*-_=+?,组成,长度8~32个字符,不能包含数据库账号名称或名称的逆序。 建议您输入高强度密码,以提高安全性,防止出现密码被暴力破解等安全风险。
  • 响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 users Array of objects 列表中每个元素表示一个数据库账号。 详情请参见表3。 表3 users元素结构说明 名称 参数类型 说明 name String 账号名。 databases Array of objects 列表中每个元素表示一个与该账号关联的数据库。 详情请参见表4。 表4 databases元素结构说明 名称 参数类型 说明 name String 数据库名。 readonly Boolean 是否为只读权限: “true”表示只读。 “false”表示可读写。 正常响应样例 { "users": [ { "name": "rds", "comment": "user comment", "databases": [ { "name": "rds-test", "readonly": false } ] }, { "name": "rds001", "comment": "user comment", "databases": null } ] } 异常响应 请参见异常请求结果。
  • 响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 users Array of objects 数据库账号信息列表。 详情请参见表3。 total_count Integer 数据库账号个数。 表3 users元素结构说明 名称 参数类型 说明 name String 账号名。 comment String 账号备注。目前仅支持MySQL 8.0.25及以上版本。 databases Array of objects 账号已授权的数据库。 详情请参见表4。 hosts Array of strings 账号配置的host信息。 表4 databases元素结构说明 参数 参数类型 描述 name String 数据库名称。 readonly Boolean 授权模式,是否只读。 正常响应样例 { "users": [ { "name": "aaa", "comment": "user comment", "databases": [ { "name": "db1", "readonly": false } ], "hosts": [ "10.%" ] } ], "total_count": 1 }
  • URI URI格式 GET /v3/{project_id}/instances/{instance_id}/db_user/detail?page={page}&limit={limit} 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 实例ID。 page 是 分页页码,从1开始。 limit 是 每页数据条数。取值范围[1, 100]。
  • 请求消息 参数说明 表2 参数说明 名称 是否必选 参数类型 说明 name 是 String 数据库账号名称。 数据库账号名称在1到128个字符之间,不能和系统用户名称相同。 系统用户包括:rdsadmin, rdsuser, rdsbackup, rdsmirror。 password 是 String 数据库账号密码。 取值范围:非空,密码长度在8到32个字符之间,至少包含大写字母、小写字母、数字、特殊字符~!@#$%^*-_+?,三种字符的组合,不能与账号名或倒序的账号名相同。 建议您输入高强度密码,以提高安全性,防止出现密码被暴力破解等安全风险。