华为云用户手册

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/proxy-list 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

URI URI格式 POST /v3/{project_id}/instances/{instance_id}/database 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 name 是 String 参数解释： 数据库名称。 约束限制： 不涉及。 取值范围： 数据库名称长度可在1～64个字符之间，由字母、数字、中划线、下划线或英文句点组成，不能包含其他特殊字符，且不能以RDS for SQL Server系统库开头或结尾。 RDS for SQL Server系统库包括master，msdb，model，tempdb，resource以及rdsadmin。 默认取值： 不涉及。

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 db_name 是 String 参数解释： 数据库名称。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 users 是 Array of objects 参数解释： 每个元素是与数据库相关联的账号。单次请求最多支持50个元素。 每个元素结构请参见表3。 表3 users列表元素数据结构说明 名称 是否必选 参数类型 说明 name 是 String 参数解释： 数据库账号名称。 约束限制： 不涉及。 取值范围： 数据库账号名称在1到128个字符之间，不能和系统用户名称相同。 系统用户包括：rdsadmin, rdsuser, rdsbackup, rdsmirror。 默认取值： 不涉及。

请求示例 DELETE https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/a8abe84a41364097be7c233c39275087in04/db_privilege { "db_name": "rds-test", "users": [ { "name": "rds" }, { "name": "rds001" } ] }

URI URI格式 DELETE /v3/{project_id}/instances/{instance_id}/db_privilege 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

URI URI格式 PUT /v3/{project_id}/instances/{instance_id}/extensions 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

请求示例 更新数据库db1的插件pg_stat_statements。 PUT https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in03/extensions { "database_name" : "db1", "extension_name" : "pg_stat_statements" }

响应消息 正常响应要素说明 表2 要素说明 参数 参数类型 描述 total_count Integer 参数解释： 历史记录总数。 取值范围： 不涉及。 histories Array of objects 参数解释： 参数修改历史。 详情请参见表3。 表3 histories字段数据结构说明 名称 参数类型 说明 parameter_name String 参数解释： 参数名称。 取值范围： 不涉及。 old_value String 参数解释： 旧参数值。 取值范围： 不涉及。 new_value String 参数解释： 新参数值。 取值范围： 不涉及。 update_result String 参数解释： 更新结果。 取值范围： SUC CES S：成功。 FAILED：失败。 applied Boolean 参数解释： 是否已应用。 取值范围： true：已应用。 false：未应用。 update_time String 参数解释： 参数修改时间。 取值范围： 不涉及。 apply_time String 参数解释： 参数应用时间。 取值范围： 不涉及。 正常响应样例 { "total_count" : 3, "histories" : [ { "parameter_name" : "fill factor (%)", "old_value" : "0", "new_value" : "2", "update_result" : "SUCCESS", "applied" : true, "update_time" : "2022-10-29T09:39:21+0000", "apply_time" : "2022-10-31T01:46:29+0000" }, { "parameter_name" : "remote login timeout (s)", "old_value" : "10", "new_value" : "20", "update_result" : "SUCCESS", "applied" : true, "update_time" : "2022-10-29T09:38:36+0000", "apply_time" : "2022-10-29T09:38:36+0000" }, { "parameter_name" : "remote query timeout (s)", "old_value" : "600", "new_value" : "601", "update_result" : "SUCCESS", "applied" : true, "update_time" : "2022-10-29T09:40:30+0000", "apply_time" : "2022-10-29T09:40:30+0000" } ] } 异常响应 请参见异常请求结果。

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/configuration-histories?offset={offset}&limit={limit}&start_time={start_time}&end_time={end_time}¶m_name={param_name} 参数说明 表1 参数说明 名称 是否必选 参数类型 说明 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 String 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 offset 否 Integer 参数解释： 分页参数。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 0 limit 否 Integer 参数解释： 分页参数。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 10 start_time 否 String 参数解释： 开始时间。 约束限制： 不涉及。 取值范围： 格式为“yyyy-mm-ddThh:mm:ssZ”。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 默认取值： 默认为当前时间的前7天。 end_time 否 String 参数解释： 结束时间。 约束限制： 不涉及。 取值范围： 格式为“yyyy-mm-ddThh:mm:ssZ”。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 默认取值： 默认为当前时间。 param_name 否 String 参数解释： 参数名称。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/proxy/flavors 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 表2 请求参数 参数 是否必选 参数类型 描述 offset 否 Integer 参数解释： 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。 约束限制： 不涉及。 取值范围： 必须为数字，不能为负数。 默认取值： 默认为0，偏移0条数据，表示从第一条数据开始查询。 limit 否 Integer 参数解释： 查询记录数。 约束限制： 不涉及。 取值范围： 1~100 默认取值： 100

响应消息 正常响应要素说明 表3 要素说明 名称 参数类型 说明 compute_flavor_groups Array of objects 参数解释： 规格组信息。 详情请参见表4。 表4 compute_flavor_groups元素结构说明 名称 参数类型 说明 group_type String 参数解释： 规格组类型。 取值范围： X86 ARM compute_flavors Array of objects 参数解释： 规格信息。 详情请参见表5。 表5 compute_flavors元素结构说明 参数 参数类型 描述 id String 参数解释： 数据库代理规格ID。 取值范围： 不涉及。 code String 参数解释： 数据库代理规格码。 取值范围： 不涉及。 cpu String 参数解释： CPU大小。 取值范围： 例如：1表示1U。 mem String 参数解释： 内存大小，单位为GB。 取值范围： 不涉及。 db_type String 参数解释： 数据库类型。 取值范围： 不涉及。 az_status Object 参数解释： 可用区信息，其中key是该规格绑定的可用区，value是该规格在对应可用区中的状态。仅展示数据库主实例所在可用区规格状态。 取值范围： normal：正常。 abandon：禁用。 正常响应样例 { "compute_flavor_groups" : [ { "group_type" : "X86", "compute_flavors" : [ { "id" : "3208f282-7815-4ff8-9466-90a6fedd6b52", "code" : "rds.proxy.large.2", "cpu" : "2", "mem" : "4", "db_type" : "Proxy", "az_status" : { "aaa" : "normal" } } ] } ] } 异常响应 请参见异常请求结果。

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 name 是 String 参数解释： 数据库账号名称。 约束限制： 不涉及。 取值范围： 数据库账号名称在1到128个字符之间，不能和系统用户名称相同。 系统用户包括：rdsadmin, rdsuser, rdsbackup, rdsmirror。 默认取值： 不涉及。 password 是 String 参数解释： 数据库账号密码。 约束限制： 建议您输入高强度密码，以提高安全性，防止出现密码被暴力破解等安全风险。 取值范围： 非空，密码长度在8到32个字符之间，至少包含大写字母、小写字母、数字、特殊字符~!@#$%^*-_+?,三种字符的组合，不能与账号名或倒序的账号名相同。 默认取值： 不涉及。

URI URI格式 POST /v3/{project_id}/instances/{instance_id}/db_user 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 cur_delay_time_mills int 参数解释： 当前配置的延迟时间，单位ms。 取值范围： 延迟时间由实例参数“recovery_min_apply_delay”控制，可通过修改该参数设置实例wal日志回放延迟时间。修改实例参数请参考修改指定实例的参数。 delay_time_value_range String 参数解释： 延迟时间参数取值范围。 取值范围： 不涉及。 real_delay_time_mills int 参数解释： 真实延迟时间，单位ms。 取值范围： 不涉及。 cur_log_replay_paused boolean 参数解释： 当前日志回放状态。 取值范围： true表示回放暂停。 false表示回放正常。 latest_receive_log String 参数解释： 最新接收的日志。 取值范围： 不涉及。 latest_replay_log String 参数解释： 最新回放的日志位点。 取值范围： 不涉及。 正常响应样例 { "cur_delay_time_mills" : 0, "delay_time_value_range" : "0-2147483647", "real_delay_time_mills" : 0, "cur_log_replay_paused" : true, "latest_receive_log" : "0/8000060", "latest_replay_log" : "0/8000060" } 异常响应 请参见异常请求结果。

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/replay-delay/show 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 total_count Integer 参数解释： host总数。 取值范围： 不涉及。 hosts Array of objects 参数解释： host列表。 详情请参见表3。 表3 hosts元素结构说明 名称 参数类型 说明 id String 参数解释： host ID。 取值范围： 不涉及。 host String 参数解释： host地址。 取值范围： 不涉及。 host_name String 参数解释： host名称。 取值范围： 不涉及。 正常响应样例 { "total_count" : 1, "hosts" : [ { "id" : "527dd9ca-cc2c-4bac-8707-f9b4f55343f4", "host" : "192.168.0.90", "host_name" : "MSSQL-00E5FB7A" } ] } 异常响应 请参见异常请求结果。

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/msdtc/hosts?offset={offset}&limit={limit} 参数说明 表1 参数说明 参数 是否必选 参数类型 说明 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 String 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 offset 否 Integer 参数解释： 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。 约束限制： 不涉及。 取值范围： 必须为数字，不能为负数。 默认取值： 默认为0，偏移0条数据，表示从第一条数据开始查询。 limit 否 Integer 参数解释： 查询记录数。 约束限制： 不涉及。 取值范围： 1~100 默认取值： 10

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 datastore_version_name String 参数解释： 数据库版本名称。 取值范围： 不涉及。 datastore_name String 参数解释： 数据库名称。 取值范围： 不涉及。 created String 参数解释： 创建时间。 取值范围： 格式为"yyyy-MM-ddTHH:mm:ssZ"。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 updated String 参数解释： 更新时间。 取值范围： 格式为"yyyy-MM-ddTHH:mm:ssZ"。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 configuration_parameters Array of objects 参数解释： 参数对象，用户基于默认参数模板自定义的参数配置。 详情请参见表3。 表3 configuration_parameters字段数据结构说明 名称 参数类型 说明 name String 参数解释： 参数名称。 取值范围： 不涉及。 value String 参数解释： 参数值。 取值范围： 不涉及。 restart_required Boolean 参数解释： 是否需要重启。 取值范围： “false”表示否。 “true”表示是。 readonly Boolean 参数解释： 是否只读。 取值范围： “false”表示否。 “true”表示是。 value_range String 参数解释： 参数值范围。 取值范围： 如Integer取值0-1、Boolean取值true或者false等。 type String 参数解释： 参数类型。 取值范围： 取值为“string”、“integer”、“boolean”、“list”或“float”之一。 description String 参数解释： 参数描述。 取值范围： 不涉及。 正常响应样例 { "datastore_version_name": "5.7", "datastore_name": "mysql", "created": "2018-10-11 11:40:44", "updated": "2018-10-11 11:40:44", "configuration_parameters": [{ "name": "auto_increment_increment", "value": "1", "restart_required": false, "readonly": false, "value_range": "1-65535", "type": "integer", "description": "auto_increment_increment和auto_increment_offset 用于master-to-master的复制，并可以用来控制AUTO_INCREMENT列的操作。" }] } 异常响应 请参见异常请求结果。

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/configurations 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

请求示例 修改参数模板的参数值。 PUT https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/configurations/463b4b58-d0e8-4e2b-9560-5dea4552fde9 { "name": "configuration_test", "description": "configuration_test", "values": { "div_precision_increment": "6", "connect_timeout": "20" } }

URI URI格式 PUT /v3/{project_id}/configurations/{config_id} 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 config_id 是 参数解释： 参数模板ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

接口约束 支持的数据库引擎：MySQL、PostgreSQL、Microsoft SQL Server。 修改参数模板名称“name”不能与默认参数模板或已有参数模板的名称重复，默认参数模板不允许修改。 修改的参数必须在指定数据库版本的默认参数范围内，具体可配置范围请参见《云数据库 RDS用户指南》中“修改实例参数”的内容。 敏感参数，例如：“lower_case_table_names”，修改存在风险，详情请参见《云数据库RDS用户指南》中“RDS for MySQL参数调优建议”的内容。 要修改的参数信息，不可全部为空。

响应消息 正常响应要素说明 表3 要素说明 名称 参数类型 说明 configuration Object 参数解释： 参数模板信息。详情请参见表4。 表4 configuration字段数据结构说明 名称 参数类型 说明 id String 参数解释： 参数模板ID。 取值范围： 不涉及。 name String 参数解释： 参数模板名称。 取值范围： 不涉及。 ignored_params List 参数解释： 请求参数“values”中被忽略掉，没有生效的参数名称列表。 当参数不存在时，参数修改不会下发，并通过此参数返回所有被忽略的参数名称。 取值范围： 不涉及。 正常响应样例 { "configuration": { "id": "463b4b58-d0e8-4e2b-9560-5dea4552fde9", "name": "configuration_test", "ignored_params": {} } } 异常响应 请参见异常请求结果。

URI URI格式 DELETE /v3/{project_id}/instances/{instance_id}/sql-limit 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

URI URI格式 DELETE /v3/{project_id}/instances/{instance_id}/proxy/{proxy_id} 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 proxy_id 是 参数解释： 数据库代理ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

请求示例 开启SQL限流。 PUT https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/ 49b9dd1d6f464ba4bc91df5cbd2e52ebin03/sql-limit/switch { "db_name" : "postgres", "id" : "1", "action" : "open" }

请求消息 表2 参数说明 参数 是否必选 参数类型 描述 db_name 是 String 参数解释： 数据库名称。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 id 是 String 参数解释： SQL限流ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 action 是 String 参数解释： SQL限流动作标志。 约束限制： 不涉及。 取值范围： open：表示开启当前SQL限流。 close：表示关闭当前SQL限流。 disable_all：表示禁用所有SQL限流。 默认取值： 不涉及。

URI URI格式 PUT /v3/{project_id}/instances/{instance_id}/sql-limit/switch 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 users Array of objects 参数解释： 列表中每个元素表示一个数据库账号。 详情请参见表3。 total_count Integer 参数解释： 数据库用户总数。 取值范围： 不涉及。 表3 users元素结构说明 名称 参数类型 说明 name String 参数解释： 账号名。 取值范围： 不涉及。 state String 参数解释： 数据库用户状态。 取值范围： “unavailable”表示不可用。 “available”表示可用。 正常响应样例 { "users": [ { "name": "rdsuser", "state": "available" }, { "name": "login001", "state": "available" } ], "total_count": 2 } 异常响应 请参见异常请求结果。