华为云用户手册

请求示例 延迟库只读恢复库到主实例。 POST https://rds.cn-north-4.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/794c38e5309344818f4b33b86ebce9b4in03/log-replay/database { "databases" : [ { "old_name" : "old", "new_name" : "new" } ] }

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/parameter/{name} 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 instance_id 是 实例ID。 name 是 参数名称。当前只支持查询shared_preload_libraries。

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

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 instance_id String 实例ID。 tde_status String TDE开启状态。 枚举值： open：已开启 close：关闭中 正常响应样例 {"instance_id":"3d39c18788b54a919bab633874c159dfin04","tde_status":"open"} 异常响应 请参见异常请求结果。

请求消息 请求参数 表2 参数说明 名称 参数类型 是否必选 说明 target_version String 是 目标版本。 URI样例 https://{Endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/3aa441c4c98a4b36b100a7e3e87d17cein03/major-version/inspection{ "target_version": "14.9.0"}

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 recycle_policy 是 Object 每个元素都是与回收站相关信息。 每个元素结构请参见表3。 表3 recycle_policy元素说明 名称 是否必选 参数类型 说明 retention_period_in_days 否 String 保留时间，设置已删除实例保留天数，支持整数，可设置范围为1~7天。 当“retention_period_in_days”为空，保留时间默认是7天。

请求消息 表2 请求参数 参数 是否必选 参数类型 描述 数组元素 否 Array of objects 修改参数。 详情请参见表3。 表3 参数说明 参数 是否必选 参数类型 描述 type 是 String 连接类型。枚举值：host、hostssl、hostnossl database 是 String 数据库名。除template0，template1的数据库名，多个以逗号隔开。 user 是 String 除内置用户（rdsAdmin, rdsMetric, rdsBackup, rdsRepl, rdsProxy）以外的用户名。 值为all：表示当前实例的所有数据库用户。 值为具体的用户名，多个以逗号隔开。 address 是 String 客户端IP地址。0.0.0.0/0表示允许用户从任意IP地址访问数据库。 mask 否 String 掩码，默认为空字符串。 method 是 String 认证方式。枚举值：reject、md5、scram-sha-256 priority 是 Integer 优先级，表示配置的先后。

请求示例 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/e28979107ed04d3b8b2f1b819b8d2be3in03/hba-info[ { "type" : "host", "database" : "all", "user" : "all", "address" : "0.0.0.0/0", "mask" : "", "method" : "md5", "priority" : 0 } ]

请求示例 DELETE https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/e28979107ed04d3b8b2f1b819b8d2be3in03/hba-info[ { "type" : "host", "database" : "all", "user" : "all", "address" : "0.0.0.0/0", "mask" : "", "method" : "md5", "priority" : 0 } ]

请求消息 表2 请求参数 参数 是否必选 参数类型 描述 数组元素 否 Array of objects 修改参数。 详情请参见表3。 表3 参数说明 参数 是否必选 参数类型 描述 type 是 String 连接类型。枚举值：host、hostssl、hostnossl database 是 String 数据库名。除template0，template1的数据库名，多个以逗号隔开。 user 是 String 除内置用户（rdsAdmin, rdsMetric, rdsBackup, rdsRepl, rdsProxy）以外的用户名。 值为all：表示当前实例的所有数据库用户。 值为具体的用户名，多个以逗号隔开。 address 是 String 客户端IP地址。0.0.0.0/0表示允许用户从任意IP地址访问数据库。 mask 否 String 掩码，默认为空字符串。 method 是 String 认证方式。枚举值：reject、md5、scram-sha-256 priority 是 Integer 优先级，表示配置的先后。

请求消息 参数说明 表2 参数说明 参数 是否必选 参数类型 描述 pause_log_replay 是 String 中止/恢复wal日志回放。 “true”表示中止回放。 “false”表示恢复回放。 取其他值或值为空表示不做操作。 URI样例 PUT https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/49b9dd1d6f464ba4bc91df5cbd2e52ebin03/log-replay/update 请求示例 中止wal日志在只读实例的回放。 { "pause_log_replay" : "true" }

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 proxy Object Proxy实例信息。 详情请参见表3。 master_instance Object 主实例信息。 详情请参见表4。 readonly_instances Array of objects 只读实例信息。 详情请参见表5。 表3 proxy元素数据结构说明 名称 参数类型 说明 pool_id String Proxy实例ID。 status String Proxy实例开启状态，取值范围如下。 open：打开。 closed：关闭。 frozen：已冻结。 opening：打开中。 closing：关闭中。 freezing：冻结中。 unfreezing：解冻中。 address String Proxy读写分离地址。 elb_vip String elb模式的虚拟ip信息。 eip String 弹性公网IP信息。 port Integer Proxy端口信息。 pool_status String Proxy实例状态。 abnormal：异常。 normal：正常。 creating：创建中。 deleted：已删除。 delay_threshold_in_kilobytes Integer 延时阈值（单位：KB）。 cpu String Proxy实例规格的CPU数量。 mem String Proxy实例规格的内存数量。 node_num Integer Proxy节点个数。 nodes Array of objects Proxy节点信息。 详情请参见表6。 mode String Proxy主备模式，取值范围：Ha。 表4 master_instance元素数据结构说明 名称 参数类型 说明 id String 主实例ID。 status String 主实例状态。 name String 主实例名称。 weight Integer 主实例读写分离权重。 available_zones Array of objects 可用区信息。 详情请参见表7。 cpu_num Integer 主实例CPU个数。 表5 readonly_instances元素数据结构说明 名称 参数类型 说明 id String 只读实例ID。 status String 只读实例状态。 name String 只读实例名称。 weight Integer 只读实例读写分离权重。 available_zones Array of objects 可用区信息。 详情请参见表7。 cpu_num Integer 只读实例CPU个数。 表6 nodes元素数据结构说明 名称 参数类型 说明 id String Proxy节点ID。 name String Proxy节点名称。 role String Proxy节点角色。 master：主节点。 slave：备节点。 az_code String 可用区。 status String Proxy节点状态。 normal：正常。 abnormal：异常。 creating：创建中。 deleted：已删除。 frozen_flag Integer Proxy节点是否被冻结。 0：未冻结。 1：冻结。 2：冻结删除。 表7 available_zones元素数据结构说明 名称 参数类型 说明 code String 可用区编码。 description String 可用区描述。 正常响应样例 { "proxy":{ "pool_id":"c6ee492784b640e694f1da0201cd82c8po03", "status":"open", "address":"192.168.0.60", "elb_vip":null, "eip":null, "port":3306, "pool_status":"normal", "delay_threshold_in_kilobytes":30, "cpu":"4", "mem":"8", "node_num":2, "nodes":[ { "id":"4fb00607cffd42dc9583ca09863df93cpn03", "name":"PROXY-c6ee492784b640e694f1da0201cd82c8po03_1", "role":"slave", "az_code":"az1xahz", "status":"normal", "frozen_flag":0 }, { "id":"191f3164f918463bb6aedeb6ba742920pn03", "name":"PROXY-c6ee492784b640e694f1da0201cd82c8po03_0", "role":"master", "az_code":"az1xahz", "status":"normal", "frozen_flag":0 } ], "mode":"Ha" }, "master_instance":{ "id":"49fcbb94435c4d89930e91dcf5884909in03", "status":"normal", "name":"proxy-hwt-0922-3", "weight":0, "available_zones":[ { "code":"az1xahz", "description":"可用区1" } ], "cpu_num":8 }, "readonly_instances":[ { "id":"83251d1398594b9fbfc8f1ab8b8228b2in03", "status":"normal", "name":"replica-a392", "weight":100, "available_zones":[ { "code":"az1xahz", "description":"可用区1" } ], "cpu_num":4 } ]} 异常响应 请参见异常请求结果。

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/proxy URI样例 https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/f569f1358436479dbcba8603c32cc4aein03/proxy 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 实例ID。

接口约束 实例在创建、变更规格、修改端口、异常或冻结状态下不能执行该操作。 除RDS界面和API以外的其他方式创建的数据库和账号，如果创建的数据库名和账号名不满足数据库命名规则（参见表2）和账号命名规则（参见表2），例如包含中文或不支持的特殊字符，那么该数据库和账号不支持RDS界面或API的数据库管理和账号管理功能。 如果源库的数据库名和账号名不满足数据库命名规则（参见表2）和账号命名规则（参见表2），迁移到目标库RDS for MySQL后，该数据库和账号也不支持RDS界面或API的数据库管理和账号管理功能。

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 users Array of objects 列表中每个元素表示一个数据库用户。 详情请参见表3。 total_count Integer 数据库用户总数。 表3 users元素结构说明 名称 参数类型 说明 name String 账号名。 attributes Object 用户的权限属性。 详情请参见表4。 memberof Array of strings 用户的默认权限。 comment String 用户备注。 表4 attributes 元素结构说明 名称 参数类型 说明 rolsuper Boolean 用户是否具有超级用户权限，取值为“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”。 正常响应样例 {"users": [{ "name": "rdsuser", "attributes": { "rolsuper": false, "rolinherit": true, "rolcreaterole": true, "rolcreatedb": true, "rolcanlogin": true, "rolconnlimit": -1, "rolreplication": true, "rolbypassrls": false }, "memberof": ["pg_monitor", "pg_read_all_stats", "pg_stat_scan_tables", "pg_signal_backend"]}, { "name": "rdsuser1", "attributes": { "rolsuper": false, "rolinherit": true, "rolcreaterole": true, "rolcreatedb": true, "rolcanlogin": true, "rolconnlimit": -1, "rolreplication": true, "rolbypassrls": false}, "memberof": []}],"total_count": 2}

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 database_schemas Array of objects 列表中每个元素表示一个数据库schema。 详情请参见表3。 total_count Integer 数据库schema总数。 表3 users元素结构说明 名称 参数类型 说明 schema_name String schema名称。 owner String schema所属用户。 正常响应样例 { "database_schemas": [{ "schema_name": "rds_user1", "owner": "root" }],"total_count": 1}

响应消息 正常响应要素说明 表3 要素说明 名称 参数类型 说明 job_id String 任务ID。 restart_required Boolean 实例是否需要重启。 true，需要重启。 false，不需要重启。 正常响应样例 { "job_id" : "e7a7535b-eb9b-45ac-a83a-020dc5016d94", "restart_required" : true } 异常响应 请参见异常请求结果。

URI URI格式 PUT /v3/{project_id}/instances/{instance_id}/parameter/{name} 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 instance_id 是 实例ID。 name 是 参数名称。当前只支持修改shared_preload_libraries。

请求示例 修改实例shared_preload_libraries参数的值。 PUT https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/f569f1358436479dbcba8603c32cc4aein03/parameter/shared_preload_libraries{ "value" : "passwordcheck.so,pg_stat_statements,pg_sql_history"}

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 replica_state String 同步状态，取值范围是0或-1，0表示正常，-1表示异常。 说明： 主实例不存在时，主实例和灾备实例间的复制状态发生异常。 wal_write_receive_delay_in_mb String 发送延迟大小（MB），即主实例当前wal日志写入位点与灾备实例当前接收wal日志位点的差值。 wal_write_replay_delay_in_mb String 端到端延迟大小（MB），即主实例当前wal日志写入位点与灾备实例当前回放wal日志位点的差值。 wal_receive_replay_delay_in_ms String 回放延迟时间（ms），即数据在灾备上回放的延迟时间。 正常响应样例 { "replica_state": "0", "wal_write_receive_delay_in_mb": "10.0", "wal_write_replay_delay_in_mb": "10.0", "wal_receive_replay_delay_in_ms": "0"} 异常响应 请参见异常请求结果。

错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 错误码列表： 表1 v3错误码说明 状态码 错误码 说明 400 DBS.01010220 当前实例不是只读状态。 500 DBS.01010221 解除节点只读状态失败。 500 DBS.108000 服务器错误。 500 DBS.108002 服务器错误。 500 DBS.108005 服务器错误。 400 DBS.200001 参数错误。 404 DBS.200002 RDS实例不存在。 400 DBS.200004 参数错误。 500 DBS.200005 服务器错误。 400 DBS.200006 请求为空，请输入请求参数。 404 DBS.200008 请检查数据库，确认实例的虚拟机信息，找不到该实例的虚拟机信息。 403 DBS.200010 实例ID和用户ID可能为空，或者操作越权。 409 DBS.200011 该实例正在进行其它操作或该实例故障，无法执行该操作，请稍后重试。 404 DBS.200013 源实例不存在。 409 DBS.200019 该实例正在进行其他操作或该实例故障，无法执行该操作，请稍后重试。 400 DBS.200021 实例名非法。 409 DBS.200022 实例名称已存在。 400 DBS.200023 卷大小超出允许范围。 400 DBS.200024 Region非法。 400 DBS.200025 非法的可用区。 400 DBS.200026 卷类型非法。 400 DBS.200027 卷大小不是10的整数倍。 400 DBS.200037 实例引擎版本不一致。 400 DBS.200038 当前实例数据库主备同步关系异常，无法执行该操作。 400 DBS.200039 当前实例主备同步延时大于5分钟，不允许此操作。 400 DBS.200040 不支持的数据库类型或版本。 400 DBS.200041 数据库版本非法。 400 DBS.200042 Datastore不存在。 400 DBS.200043 HA同步模式非法。 403 DBS.200044 访问资源不存在，或者无访问权限。 404 DBS.200045 RDS实例不存在。 413 DBS.200046 实例数量达到配额。 409 DBS.200047 该实例正在进行其它操作或该实例故障，无法执行该操作，请稍后重试。 400 DBS.200048 VPC id非法。 400 DBS.200049 子网的网络id非法。 404 DBS.200050 安全组不存在，或不属于该VPC。 400 DBS.200051 不合法的ha模式 400 DBS.200052 数据库root密码非法。 400 DBS.200053 所选规格不存在。 400 DBS.200054 所选规格非法。 400 DBS.200055 replica_of_id非法。 400 DBS.200056 节点个数达到最大值。 400 DBS.200062 数据库用户名非法。 400 DBS.200063 集群模式非法。 400 DBS.200076 实例或节点非正常状态。 400 DBS.200080 主备节点正在进行数据同步，请稍后重试。 400 DBS.200086 实例状态不允许做该操作。 400 DBS.200087 单个实例标签数量达到最大配额。 400 DBS.200098 该资源标签已存在。 400 DBS.200121 请选择不同于备机的可用区做迁移。 400 DBS.200203 查询实例失败。 500 DBS.200208 服务器错误。 400 DBS.200302 卷大小不是10的整数倍。 400 DBS.200303 扩容次数达到最大限制。 400 DBS.200306 扩容参数不合法。 400 DBS.200308 备机扩容后的大小不能超过主机。 400 DBS.200311 节点状态异常, 不允许扩容, 请联系技术服务处理。 409 DBS.200316 当前实例状态为存储空间满，不能进行该操作 409 DBS.200402 操作不合法。 400 DBS.200405 参数错误。 404 DBS.200408 节点信息填写错误。 400 DBS.200461 参数值超出范围。 404 DBS.200470 Region或可用区不存在。 404 DBS.200501 子网不存在，或不属于该VPC。 404 DBS.200503 VPC不存在，或不属于该用户。 400 DBS.200504 数据库版本非法。 400 DBS.200506 KMS非法。 400 DBS.200507 密钥失效或已删除。 400 DBS.200543 任务不存在。 404 DBS.200602 该实例不存在。 403 DBS.200604 实例ID和用户ID可能为空，或者操作越权。 403 DBS.200810 不能在只读实例中创建数据库。 403 DBS.200819 不能在只读实例中删除数据库用户。 500 DBS.200821 修改数据库用户权限失败 400 DBS.200823 数据库不存在 400 DBS.200824 数据库账号不存在 400 DBS.200825 不能在只读实例上修改权限操作。 409 DBS.200826 数据库名称已存在 409 DBS.200827 账号名称已存在。 409 DBS.200828 数据库内置账号，用户不可创建。 500 DBS.200835 删除数据库失败，数据库锁等待超时。 500 DBS.200811 创建数据库失败。 403 DBS.201003 访问资源不存在，或者无访问权限。 400 DBS.201006 参数错误。 404 DBS.201010 备份信息不存在。 400 DBS.201014 实例状态不允许做该操作。 404 DBS.201028 实例不存在或已删除。 400 DBS.201035 输入的数据库名重复或者输入的数据库名与目标库上的重复。 400 DBS.201041 带有外键的表不允许该操作 400 DBS.201101 备份周期非法。 400 DBS.201103 备份开始时间非法。 400 DBS.201106 保留天数非法。 409 DBS.201201 对象已存在。 409 DBS.201202 该实例正在进行其它操作或该实例故障，无法执行该操作，请稍后重试 400 DBS.201203 备份文件不存在。 409 DBS.201205 正在备份中，请稍等。 400 DBS.201207 不支持该数据库引擎或版本。 400 DBS.201208 备份状态不允许该操作。 404 DBS.212001 参数组不存在。 400 DBS.212002 参数组配额错误。 400 DBS.212003 不支持此操作。 400 DBS.212004 参数组更新错误。 400 DBS.212005 节点不属于组。 409 DBS.212006 该实例正在进行其它操作或该实例故障，无法执行该操作，请稍后重试。 400 DBS.212007 引擎不存在。 400 DBS.212008 不支持的引擎。 400 DBS.212009 任务处理失败。 400 DBS.212010 绑定正在执行。 400 DBS.212011 绑定失败。 400 DBS.212012 参数不存在。 404 DBS.212013 对象不存在。 400 DBS.212014 节点没有默认参数组。 400 DBS.212015 部分成功。 400 DBS.212016 参数更新失败。 400 DBS.212017 参数错误。 422 DBS.212019 请求中的参数或对象不能被正确识别。 400 DBS.212025 更新失败。 400 DBS.212030 参数错误。 400 DBS.212032 已被应用。 400 DBS.212037 参数设置不正确。 500 DBS.213002 请求处理失败。 500 DBS.213004 请求处理失败。 400 DBS.216028 内部资源配额不足。 400 DBS.280001 参数错误。 409 DBS.280011 该实例正在进行其它操作或该实例故障，无法执行该操作，请稍后重试。 403 DBS.280015 访问资源不存在，或者无访问权限。 403 DBS.280020 账户受限。 401 DBS.280058 当前用户没有操作权限，请通过 IAM 检查账户权限。 403 DBS.280056 Token非法。 404 DBS.280110 所选实例不存在。 400 DBS.280127 备份描述非法。 400 DBS.280128 数据库名不存在。 400 DBS.280204 输入参数不合法。 400 DBS.280214 备份不存在。 400 DBS.280216 备份开始时间非法。 400 DBS.280235 数据库类型非法 400 DBS.280237 Datastore为空。 400 DBS.280238 不支持的数据库类型或版本。 400 DBS.280239 所选规格非法。 400 DBS.280241 卷类型非法。 400 DBS.280242 卷大小超出允许范围。 400 DBS.280246 数据库root密码非法 400 DBS.280250 备份保留期非法。 400 DBS.280251 备份周期不合法。 400 DBS.280253 备份开始时间非法。 400 DBS.280262 Ha同步模式非法。 400 DBS.280270 参数不存在。 400 DBS.280271 参数值超出范围。 400 DBS.280272 新增tag存在重复的key。 404 DBS.280275 源实例不存在。 400 DBS.280277 备份名称非法。 400 DBS.280285 可用区取值非法 400 DBS.280288 规格非法 400 DBS.280311 存储空间大小非法 400 DBS.280325 硬盘信息不合法 400 DBS.280328 当前实例类型不支持此操作。 400 DBS.280342 集群模式非法 400 DBS.280364 数据库端口号无效 400 DBS.280402 Ha模式非法。 400 DBS.280404 实例ID非法。 409 DBS.280406 实例类型或状态受限，操作不允许。 400 DBS.280434 所选规格码非法。 400 DBS.280448 当前卷类型已售罄。 400 DBS.280449 不能对冻结的对象执行该操作。 400 DBS.280450 当前规格已售罄。 400 DBS.280457 协调节点数量非法。 400 DBS.280458 分片数量非法 400 DBS.280461 扩容分片数非法 400 DBS.280489 实例已关联DDM组件，请先在DDM界面删除。 400 DBS.280490 备份已关联DDM组件，请先在DDM界面删除。 400 DBS.280649 实例名长度非法。 400 DBS.280810 设置数据库用户读写权限失败，用户可能不存在，请检查配置。 400 DBS.280812 实例已处于该状态，请勿重复点击。 400 DBS.280813 当前实例存在大事务或DDL等场景，不能进行该操作。 400 DBS.280816 当前实例处于DRS迁移任务中，请稍后重试。 400 DBS.290000 参数错误。 400 DBS.290001 参数错误。 404 DBS.290002 所选规格不存在。 413 DBS.290003 实例数量达到配额。 404 DBS.290005 该实例不存在。 500 DBS.290006 请求处理失败。 404 DBS.290011 RDS实例不存在。 404 DBS.290013 未找到资源。 500 DBS.290015 请求处理失败。 400 DBS.301051 该实例不存在容灾关系。 400 DBS.301132 实例已经是停止状态。 400 DBS.301133 实例已经是开启状态。 父主题： 附录

URI URI格式 DELETE /v3/{project_id}/instances/{instance_id}/proxy URI样例 https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/f569f1358436479dbcba8603c32cc4aein03/proxy 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 实例ID。

请求消息 表1 参数说明 名称 是否必选 参数类型 说明 target_instance_id 是 String 解除目标的实例ID。 target_project_id 是 String 解除目标的项目 ID。 target_region 是 String 解除目标的region。 target_ip 是 String 解除目标的数据浮动IP。 is_master 是 Boolean 当前操作对象是否是主实例。 值为“true”，表示当前是主实例。 值为“false”，表示当前是灾备实例。

请求示例 解除实例容灾关系。 DELETE https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/42d4b4fc17d144bbb3ba64a306e68c72in03/delete-disaster-recovery { "target_instance_id" : "8c08eda627cc4344aca26832c87ff16cin03", "target_project_id" : "0ddd1dbcb3494d3dbdb614b39104760b", "target_region" : "cn-southwest-244", "target_ip" : "192.168.2.70", "is_master" : true }

调用样例 通过API接口来检索RDS监控指标数据，具体调用方法及参数说明请参见《 云监控服务 API参考》中的查询监控数据章节。 调用样例如下： 请求样例： /V1.0/{project_id}/metric-data?namespace=SYS.RDS&metric_name=rds001_cpu_util&dim.0=rds_cluster_id,5ea170ad-cc6b-49cd-9020-e94fdbeea391&from=1484123686000&to=1568188853000&period=300&filter=average 响应样例： { "datapoints": [ { "average": 0.35, "timestamp": 1484123400000, "unit": "Ratio" }, { "average": 0.11, "timestamp": 1484123700000, "unit": "Ratio" } ], "metric_name": "rds001_cpu_util", "httpcode" : 200, "header" : { "Transfer-Encoding" : "chunked", "Server" : "Web Server", "X-Request-Id" : "te-I- CES -APISVR25.id-0418d62a-1e76-46ff-9a5f-9ce40b336e29.ts-1484123744291.c-15046", "X-Content-Type-Options" : "nosniff", "Connection" : "keep-alive", "X-Download-Options" : "noopen", "Date" : "Wed, 11 Jan 2017 08:35:44 GMT", "X-Frame-Options" : "DENY", "Strict-Transport-Security" : "max-age=31536000; includeSubdomains;", "Cache-Control" : "no-cache", "X-XSS-Protection" : "1; mode=block;", "Content-Length" : "165", "Content-Type" : "application/json"}}

监控指标 表1 RDS性能监控列表 指标ID 指标名称 指标含义 取值范围 测量对象&监控实例类型 rds001_cpu_util CPU使用率 该指标用于统计测量对象的CPU使用率，以百分比为单位。 0-100% 测量对象：弹性云服务器，监控实例类型： MySQL PostgreSQL Microsoft SQL Server rds002_mem_util 内存使用率 该指标用于统计测量对象的内存使用率，以百分比为单位。 0-100% 测量对象：弹性云服务器，监控实例类型： MySQL PostgreSQL Microsoft SQL Server rds003_iops IOPS 该指标用于统计当前实例，单位时间内系统处理的I/O请求数量（平均值）。 ≥ 0 counts/s 测量对象：弹性云服务器，监控实例类型： MySQL PostgreSQL Microsoft SQL Server rds004_bytes_in 网络输入吞吐量 该指标用于统计平均每秒从测量对象的所有网络适配器输入的流量，以字节/秒为单位。 ≥ 0 bytes/s 测量对象：弹性云服务器，监控实例类型： MySQL PostgreSQL Microsoft SQL Server rds005_bytes_out 网络输出吞吐量 该指标用于统计平均每秒从测量对象的所有网络适配器输出的流量，以字节/秒为单位。 ≥ 0 bytes/s 测量对象：弹性云服务器，监控实例类型： MySQL PostgreSQL Microsoft SQL Server rds006_conn_count 数据库总连接数 该指标用于统计试图连接到MySQL服务器的总连接数，以个为单位。 ≥ 0 counts 测量对象：数据库 监控实例类型：MySQ L实例 rds007_conn_active_count 当前活跃连接数 该指标用于统计当前打开的连接的数量，以个为单位。 ≥ 0 counts 测量对象：数据库 监控实例类型：MySQL实例 rds008_qps QPS 该指标用于统计SQL语句查询次数，含存储过程，以次/秒为单位。 ≥ 0 queries/s 测量对象：数据库 监控实例类型：MySQL实例 rds009_tps TPS 该指标用于统计事务执行次数，含提交的和回退的，以次/秒为单位。 ≥ 0 transactions/s 测量对象：数据库 监控实例类型：MySQL实例 rds010_innodb_buf_usage 缓冲池利用率 该指标用于统计空闲的页与InnoDB缓存中缓冲池页面总数的比例，以比率为单位。 0-1 测量对象：数据库 监控实例类型：MySQL实例 rds011_innodb_buf_hit 缓冲池命中率 该指标用于统计读命中与读请求数比例，以比率为单位。 0-1 测量对象：数据库 监控实例类型：MySQL实例 rds012_innodb_buf_dirty 缓冲池脏块率 该指标用于统计InnoDB缓存中脏数据与InnoDB缓存中使用的页比例，以比率为单位。 0-1 测量对象：数据库 监控实例类型：MySQL实例 rds013_innodb_reads InnoDB读取吞吐量 该指标用于统计Innodb平均每秒读字节数，以字节/秒为单位。 ≥ 0 bytes/s 测量对象：数据库 监控实例类型：MySQL实例 rds014_innodb_writes InnoDB写入吞吐量 该指标用于统计Innodb平均每秒写字节数，以字节/秒为单位。 ≥ 0 bytes/s 测量对象：数据库 监控实例类型：MySQL实例 rds015_innodb_read_count InnoDB文件读取频率 该指标用于统计Innodb平均每秒从文件中读的次数，以次/秒为单位。 ≥ 0 counts/s 测量对象：数据库 监控实例类型：MySQL实例 rds016_innodb_write_count InnoDB文件写入频率 该指标用于统计Innodb平均每秒向文件中写的次数，以次/秒为单位。 ≥ 0 counts/s 测量对象：数据库 监控实例类型：MySQL实例 rds017_innodb_log_write_req_count InnoDB日志写请求频率 该指标用于统计平均每秒的日志写请求数，以次/秒为单位。 ≥ 0 counts/s 测量对象：数据库 监控实例类型：MySQL实例 rds018_innodb_log_write_count InnoDB日志物理写频率 该指标用于统计平均每秒向日志文件的物理写次数，以次/秒为单位。 ≥ 0 counts/s 测量对象：数据库 监控实例类型：MySQL实例 rds019_innodb_log_fsync_count InnoDB日志fsync()写频率 该指标用于统计平均每秒向日志文件完成的fsync()写数量，以次/秒为单位。 ≥ 0 counts/s 测量对象：数据库 监控实例类型：MySQL实例 rds020_temp_tbl_rate 临时表创建速率 该指标用于统计每秒在硬盘上创建的临时表数量，以个/秒为单位。 ≥ 0 counts/s 测量对象：数据库 监控实例类型：MySQL实例 rds021_myisam_buf_usage Key Buffer利用率 该指标用于统计MyISAM Key buffer的利用率，以比率为单位。 0-1 测量对象：数据库 监控实例类型：MySQL实例 rds022_myisam_buf_write_hit Key Buffer写命中率 该指标用于统计MyISAM Key buffer写命中率，以比率为单位。 0-1 测量对象：数据库 监控实例类型：MySQL实例 rds023_myisam_buf_read_hit Key Buffer读命中率 该指标用于统计MyISAM Key buffer读命中率，以比率为单位。 0-1 测量对象：数据库 监控实例类型：MySQL实例 rds024_myisam_disk_write_count MyISAM硬盘写入频率 该指标用于统计向磁盘写入索引的次数，以次/秒为单位。 ≥ 0 counts/s 测量对象：数据库 监控实例类型：MySQL实例 rds025_myisam_disk_read_count MyISAM硬盘读取频率 该指标用于统计从磁盘读取索引的次数，以次/秒为单位。 ≥ 0 counts/s 测量对象：数据库 监控实例类型：MySQL实例 rds026_myisam_buf_write_count MyISAM缓冲池写入频率 该指标用于统计向缓冲池写入索引的请求次数，以次/秒为单位。 ≥ 0 counts/s 测量对象：数据库 监控实例类型：MySQL实例 rds027_myisam_buf_read_count MyISAM缓冲池读取频率 该指标用于统计从缓冲池读取索引的请求次数，以次/秒为单位。 ≥ 0 counts/s 测量对象：数据库 监控实例类型：MySQL实例 rds028_comdml_del_count Delete语句执行频率 该指标用于统计平均每秒Delete语句执行次数，以次/秒为单位。 ≥ 0 queries/s 测量对象：数据库 监控实例类型：MySQL实例 rds029_comdml_ins_count Insert语句执行频率 该指标用于统计平均每秒Insert语句执行次数，以次/秒为单位。 ≥ 0 queries/s 测量对象：数据库 监控实例类型：MySQL实例 rds030_comdml_ins_sel_count Insert_Select语句执行频率 该指标用于统计平均每秒Insert_Select语句执行次数，以次/秒为单位。 ≥ 0 queries/s 测量对象：数据库 监控实例类型：MySQL实例 rds031_comdml_rep_count Replace语句执行频率 该指标用于统计平均每秒Replace语句执行次数，以次/秒为单位。 ≥ 0 queries/s 测量对象：数据库 监控实例类型：MySQL实例 rds032_comdml_rep_sel_count Replace_Selection语句执行频率 该指标用于统计平均每秒Replace_Selection语句执行次数，以次/秒为单位。 ≥ 0 queries/s 测量对象：数据库 监控实例类型：MySQL实例 rds033_comdml_sel_count Select语句执行频率 该指标用于统计平均每秒Select语句执行次数。 ≥ 0 queries/s 测量对象：数据库 监控实例类型：MySQL实例 rds034_comdml_upd_count Update语句执行频率 该指标用于统计平均每秒Update语句执行次数，以次/秒为单位。 ≥ 0 queries/s 测量对象：数据库 监控实例类型：MySQL实例 rds035_innodb_del_row_count 行删除速率 该指标用于统计平均每秒从InnoDB表删除的行数，以行/秒为单位。 ≥ 0 rows/s 测量对象：数据库 监控实例类型：MySQL实例 rds036_innodb_ins_row_count 行插入速率 该指标用于统计平均每秒向InnoDB表插入的行数，以行/秒为单位。 ≥ 0 rows/s 测量对象：数据库 监控实例类型：MySQL实例 rds037_innodb_read_row_count 行读取速率 该指标用于统计平均每秒从InnoDB表读取的行数，以行/秒为单位。 ≥ 0 rows/s 测量对象：数据库 监控实例类型：MySQL实例 rds038_innodb_upd_row_count 行更新速率 该指标用于统计平均每秒向InnoDB表更新的行数，以行/秒为单位。 ≥ 0 rows/s 测量对象：数据库 监控实例类型：MySQL实例 rds039_disk_util 磁盘利用率 该指标用于统计测量对象的磁盘利用率，以百分比为单位。 0-100% 测量对象：弹性云服务器，监控实例类型： MySQL PostgreSQL Microsoft SQL Server rds040_transaction_logs_usage 事务日志使用量 事务日志所占用的磁盘容量。 ≥ 0 MB 测量对象：数据库 监控实例类型：PostgreSQL实例 rds041_replication_slot_usage 复制插槽使用量 复制插槽文件所占磁盘容量。 ≥ 0 MB 测量对象：数据库 监控实例类型：PostgreSQL实例 rds042_database_connections 数据库连接数 当前连接到数据库的后端量。 ≥ 0 counts 测量对象：数据库 监控实例类型：PostgreSQL实例 rds043_maximum_used_transaction_ids 事务最大已使用ID数 事务最大已使用ID。 ≥ 0 counts 测量对象：数据库 监控实例类型：PostgreSQL实例 rds044_transaction_logs_generations 事务日志生成速率 平均每秒生成的事务日志大小。 ≥ 0 MB/s 测量对象：数据库 监控实例类型：PostgreSQL实例 rds045_oldest_replication_slot_lag 最滞后副本滞后量 多个副本中最滞后副本（依据接收到的WAL数据）滞后量。 ≥ 0 MB 测量对象：数据库 监控实例类型：PostgreSQL实例 rds046_replication_lag 复制时延 副本滞后时延。 ≥ 0 ms 测量对象：数据库 监控实例类型：PostgreSQL实例 read_count_per_second 读IOPS 该指标用于统计当前实例，单位时间内系统处理的读I/O请求数量（平均值）。 ≥ 0 counts/s 测量对象：弹性云服务器 监控实例类型：PostgreSQL实例 write_count_per_second 写IOPS 该指标用于统计当前实例，单位时间内系统处理的写I/O请求数量（平均值）。 ≥ 0 counts/s 测量对象：弹性云服务器 监控实例类型：PostgreSQL实例 inactive_logical_replication_slot 非活跃逻辑复制槽数量 该指标用于统计当前数据库中存在的非活跃逻辑复制槽数量。 ≥ 0 测量对象：数据库 监控实例类型：PostgreSQL实例 pgaudit_log_size 审计日志大小 该指标为获取当前审计日志的大小。 ≥ 0 GB 测量对象：数据库 监控实例类型：PostgreSQL实例 rds047_disk_total_size 磁盘总大小 该指标用于统计测量对象的磁盘总大小。 40GB~4000GB 测量对象：弹性云服务器，监控实例类型： MySQL PostgreSQL Microsoft SQL Server rds048_disk_used_size 磁盘使用量 该指标用于统计测量对象的磁盘使用大小。 0GB~4000GB 测量对象：弹性云服务器，监控实例类型： MySQL PostgreSQL Microsoft SQL Server rds049_disk_read_throughput 硬盘读吞吐量 该指标用于统计每秒从硬盘读取的字节数。 ≥ 0 bytes/s 测量对象：弹性云服务器，监控实例类型： MySQL PostgreSQL Microsoft SQL Server rds050_disk_write_throughput 硬盘写吞吐量 该指标用于统计每秒写入硬盘的字节数。 ≥ 0 bytes/s 测量对象：弹性云服务器，监控实例类型： MySQL PostgreSQL Microsoft SQL Server rds054_db_connections_in_use 使用中的数据库连接数 用户连接到数据库的连接数量。 ≥ 0 counts 测量对象：数据库 监控实例类型：Microsoft SQL Server实例 rds075_avg_disk_ms_per_read 硬盘读耗时 该指标用于统计某段时间平均每次读取磁盘所耗时间。 ≥ 0 ms 测量对象：弹性云服务器 监控实例类型：MySQL实例 rds076_avg_disk_ms_per_write 硬盘写耗时 该指标用于统计某段时间平均写入磁盘所耗时间。 ≥ 0 ms 测量对象：弹性云服务器 监控实例类型：MySQL实例

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 compute_flavor_groups Array of objects 计算规格列表对象。 详情请参见表3。 表3 compute_flavor_groups元素数据结构说明 名称 参数类型 说明 group_type String 群组类型。 X86：X86架构。 ARM：ARM架构。 compute_flavors Array of objects 计算规格信息。 详情请参见表4 表4 ScaleFlavors元素数据结构说明 名称 参数类型 说明 code String 规格码。 cpu String CPU个数。 mem String 内存大小（单位：GB）。 正常响应样例 { "compute_flavor_groups" : { "group_type" : "X86", "compute_flavors" : { "code" : "rds.pg.proxy.c6.large.2.ha", "cpu" : 2, "mem" : 4 } }} 异常响应 请参见异常请求结果。

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/proxy/scale/flavors URI样例 https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/f569f1358436479dbcba8603c32cc4aein03/proxy/scale/flavors 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 实例ID。

URI URI格式 GET /v3.1/{project_id}/instances/{instance_id}/proxy/scale/flavors URI样例 https://{endpoint}/v3.1/0483b6b16e954cb88930a360d2c4e663/instances/f569f1358436479dbcba8603c32cc4aein03/proxy/scale/flavors 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 实例ID。 offset 否 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。 limit 否 查询记录数。默认为100，不能为负数，最小值为1，最大值为100。

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 compute_flavor_groups Array of objects 计算规格列表对象。 详情请参见表3。 表3 compute_flavor_groups元素数据结构说明 名称 参数类型 说明 group_type String 群组类型。 X86：X86架构。 ARM：ARM架构。 compute_flavors Array of objects 计算规格信息。 详情请参见表4 表4 ScaleFlavors元素数据结构说明 名称 参数类型 说明 code String 规格码。 cpu String CPU个数。 mem String 内存大小（单位：GB）。 正常响应样例 { "compute_flavor_groups" : { "group_type" : "X86", "compute_flavors" : { "code" : "rds.pg.proxy.c6.large.2.ha", "cpu" : 2, "mem" : 4 } }} 异常响应 请参见异常请求结果。