华为云用户手册

KMS加密文件配置 CDN默认无法读取OBS桶中的加密文件，如果您的OBS桶存在此类文件，建议您慎重开启 CDN加速 ，避免加密对象泄露。如果您因业务需求，需要加速OBS桶中的KMS加密文件，请注意： 如果您的OBS桶是公有桶，CDN将无法读取桶中的KMS加密文件，从而导致回源失败，用户无法访问到加密文件。 解决方案：将公有桶中的加密文件转移到私有桶中，再接入CDN加速。 如果您的OBS桶是私有桶，需要为“CDNAccessPrivateOBS”委托配置“kms:cmk:get”和“kms:dek:crypto”权限。如此，CDN才能读取OBS私有桶中的KMS加密文件并加速，配置过程详见OBS委托授权。

CDN加速OBS文件方案 华为云CDN可以有效加速网站，为用户提供良好的体验，而OBS桶提供海量文件存储。将数据存放在OBS桶中然后通过配置CDN加速，这样构造的业务系统可以在降低成本的同时，提高终端用户使用感受。当终端用户发起访问请求时，会首先通过CDN查找对此 域名 响应速度较快的CDN节点，并查询此节点是否有缓存终端用户请求的内容。如果CDN节点有缓存用户所需资源，直接将资源返回给用户；如果CDN节点无缓存，则回源请求资源返回给用户，同时将资源缓存到CDN节点。

约束与限制 只有版本号为3.0及以上的桶支持此方案。桶版本号可以在OBS控制台上，进入桶概览页面后，在“基本信息”中查看。 当OBS配置了镜像回源且CDN侧开启Range回源时，如果镜像源站未遵循RFC Range Requests标准，对range请求响应非206 ，CDN会回源失败。如需支持该场景，请提工单申请。 当CDN源站类型为“OBS桶域名”且接入的是OBS私有桶时，不支持文件上传操作。如果您需要通过CDN将文件上传到OBS私有桶，需要以“源站域名”的形式将OBS私有桶接入CDN，同时，客户端携带鉴权请求头上传文件。 OBS私有桶以源站域名接入CDN后，因CDN无私有桶上传权限，此时客户端无法正常访问加速域名。使用GET/HEAD等方式通过此加速域名请求资源时，也需携带鉴权请求头。

方案优势 低成本 CDN加速OBS桶文件后，资源缓存在CDN节点，用户请求无需回源，而CDN加速的费用较低，二者配合使用可以节约50%到57%的带宽成本，详见通过CDN减少OBS公网带宽费用。 OBS桶提供CDN回源流量包折扣方式，使CDN从OBS桶获取数据时流量费用更低，计费详情请见CDN加速OBS计费规则。 CDN加速OBS桶不支持走内网。 高效率 华为云CDN具有加速资源丰富、节点分布广泛优势，保证将用户请求精准调度至较优边缘节点，提供有效且稳定的加速效果。 自动刷新 通过OBS控制台为您的桶绑定加速域名后，支持自动刷新配置，您可以参考配置CDN自动刷新完成相关配置。

适用场景 通过OBS桶提供文件下载业务的应用或服务。例如：通过HTTP/HTTPS提供文件下载业务的网站、工具下载、游戏客户端、APP商店等。 通过OBS桶提供音 视频点播 业务的应用或服务。例如：在线教育类网站、在线视频分享网站、互联网电视点播平台、音乐视频点播APP等。 通过OBS桶提供图片素材等的网站。例如：包括门户网站、电商平台、资讯APP、UGC应用（User Generated Content，用户原创内容）等

背景介绍 现在越来越多的行业使用OBS桶存储图片、视频、软件包等静态资源文件，并将OBS桶作为网站、论坛、APP、游戏等业务的存储源。在需要获取这些静态资源时，用户通过URL直接从OBS桶请求数据。OBS桶能够很好的解决本地存储不够用的难题，但一般情况下文件只存储在一个区域，不同区域的用户访问OBS桶的响应速度存在差异。在需要频繁访问的场景下，直接访问OBS桶来获取相应文件，还会消耗大量的流量费用。

调用API取项目ID 项目ID可通过调用查询指定条件下的项目信息API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects/”，其中“{Endpoint}”为 IAM 的终端节点，可以从终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下，其中“projects”下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "example", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

响应示例 { "tune_result": { "message_id": "6507f5070cf2476b18473d9b", "status_code": "0000", "error_message": "Success", "formatted_sql": "SELECT *\nFROM test_tb", "original_sql": "select * from test_tb", "tuning_advice": [ "最外层Select未指定Where条件，可能返回比预期更多的行。" ], "explain": [{ "id": 1, "select_type": "SIMPLE", "type": "ALL", "rows": 100512, "filtered": 100 }], "tb_pos_infos": [{ "origin_name": "test_tb", "name": "test_tb", "start": 14, "end": 21 }], "feedback_infos": {} } }

URI GET /v3/{project_id}/connections/{connection_id}/tuning/{message_id}/show-tuning-result 表1 路径参数 参数 是否必选 参数类型 描述 message_id 是 String 参数解释： 诊断信息ID。 获取方法请参见5.2.30-执行SQL诊断。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为24个字符。 默认取值： 不涉及。 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 connection_id 是 String 参数解释： 数据库用户ID。用户使用数据库账号与数据库建立的连接ID（数据库用户ID由注册数据库用户接口创建）。 取值范围： 只能由英文字母、数字、中划线组成，且长度为36个字符的UUID。

响应示例 状态码： 200 { "innodb_trx" : [ { "trx_id" : "1080883393", "trx_state" : "LOCK WAIT", "trx_started" : "2021-01-14 18:49:26", "trx_wait_started" : "2021-01-14 18:49:26", "trx_mysql_thread_id" : "115602", "trx_query" : "DELETE FROM adfasdf WHERE id =1", "trx_tables_locked" : "1", "trx_rows_locked" : "1", "trx_rows_modified" : "0", "trx_isolation_level" : "REPEATABLE READ", "innodb_wait_locks" : [ { "lock_id" : "1080883393:27750:3:2", "lock_trx_id" : "1080883393", "lock_mode" : "X", "lock_type" : "RECORD", "lock_table" : "`abc`.`adfasdf`", "lock_index" : "GEN_CLUST_INDEX", "lock_space" : "27750", "lock_page" : "3", "lock_rec" : "2", "lock_data" : "0x0000005528EC" } ], "innodb_hold_locks" : [ ] }, { "trx_id" : "1080882971", "trx_state" : "LOCK WAIT", "trx_started" : "2021-01-14 18:49:25", "trx_wait_started" : "2021-01-14 18:49:25", "trx_mysql_thread_id" : "115598", "trx_query" : "DELETE FROM adfasdf WHERE id =1", "trx_tables_locked" : "1", "trx_rows_locked" : "1", "trx_rows_modified" : "0", "trx_isolation_level" : "REPEATABLE READ", "innodb_wait_locks" : [ ], "innodb_hold_locks" : [ { "lock_id" : "1080882971:27750:3:2", "lock_trx_id" : "1080882971", "lock_mode" : "X", "lock_type" : "RECORD", "lock_table" : "`abc`.`adfasdf`", "lock_index" : "GEN_CLUST_INDEX", "lock_space" : "27750", "lock_page" : "3", "lock_rec" : "2", "lock_data" : "0x0000005528EC" } ] } ], "innodb_lock_waits" : [ { "requesting_trx_id" : "1080883393", "requested_lock_id" : "1080883393:27750:3:2", "blocking_trx_id" : "1080882971", "blocking_lock_id" : "1080882971:27750:3:2" } ], "count" : 2 }

请求示例 查询InnoDB锁等待列表。 GET https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/da304cd5bbb944de828759bc7be3d3fein01/innodb-locks?db_user_id=2c250598-1e3c-4d31-bc19-be1d866247e6

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 innodb_trx Array of InnodbTrx objects 参数解释： 当前持有或等待锁的事务信息。 取值范围： 不涉及。 innodb_lock_waits Array of InnodbLockWaits objects 参数解释： 每个事务请求的锁以及阻塞该请求的锁的对应关系。 取值范围： 不涉及。 count Integer 参数解释： 当前持有或等待锁的事务数量。 取值范围： [0, 2^31-1]，实际取决于查询。 表4 InnodbTrx 参数 参数类型 描述 trx_id String 参数解释： 事务ID。 取值范围： 不涉及。 trx_state String 参数解释： 事务状态。 取值范围： 不涉及。 trx_started String 参数解释： 事务开始时间。 取值范围： 不涉及。 trx_wait_started String 参数解释： 事务ID。 取值范围： 不涉及。 trx_mysql_thread_id String 参数解释： 会话ID，同ListProcesses接口返回的id。 取值范围： 不涉及。 trx_query String 参数解释： 事务运行的SQL语句。 取值范围： 不涉及。 trx_tables_locked String 参数解释： 加行锁的表数量。 取值范围： 不涉及。 trx_rows_locked String 参数解释： 锁定的行数量（近似值）。 取值范围： 不涉及。 trx_rows_modified String 参数解释： 事务插入或者修改的行数。 取值范围： 不涉及。 trx_isolation_level String 参数解释： 隔离级别。 取值范围： 不涉及。 innodb_wait_locks Array of InnodbLock objects 参数解释： 等待锁信息。 取值范围： 不涉及。 innodb_hold_locks Array of InnodbLock objects 参数解释： 持有锁信息。 取值范围： 不涉及。 表5 InnodbLock 参数 参数类型 描述 lock_id String 参数解释： 锁ID。 取值范围： 不涉及。 lock_trx_id String 参数解释： 事务ID。 取值范围： 不涉及。 lock_mode String 参数解释： 锁模式。 取值范围： S[,GAP] X[,GAP] IS[,GAP] IX[,GAP] AUTO_INC UNKNOWN lock_type String 参数解释： 锁类型。 取值范围： RECORD：行锁。 TABLE：表锁。 lock_table String 参数解释： 加锁的表。 取值范围： 不涉及。 lock_index String 参数解释： 如果是lock_type='RECORD' 行级锁 ,为锁住的索引，如果是表锁为null。 取值范围： 不涉及。 lock_space String 参数解释： 如果是lock_type='RECORD' 行级锁 ,为锁住的索引，如果是表锁为null。 取值范围： 不涉及。 lock_page String 参数解释： 如果是lock_type='RECORD' 行级锁 ,为锁住的页号，如果是表锁为null。 取值范围： 不涉及。 lock_rec String 参数解释： 如果是lock_type='RECORD' 行级锁，为锁住的堆号，如果是表锁为null。 取值范围： 不涉及。 lock_data String 参数解释： 事务锁住的主键值，若是表锁，则该值为null。 取值范围： 不涉及。 表6 InnodbLockWaits 参数 参数类型 描述 requesting_trx_id String 参数解释： 申请锁资源的事务ID。 取值范围： 不涉及。 requested_lock_id String 参数解释： 申请的锁的ID。 取值范围： 不涉及。 blocking_trx_id String 参数解释： 阻塞的事务ID。 取值范围： 不涉及。 blocking_lock_id String 参数解释： 阻塞的锁的ID。 取值范围： 不涉及。

URI GET /v3/{project_id}/instances/{instance_id}/innodb-locks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 instance_id 是 String 参数解释： 实例ID。标识实例的唯一标识。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 表2 Query参数 参数 是否必选 参数类型 描述 db_user_id 是 String 参数解释： 数据库用户ID。用户使用数据库账号与数据库建立的连接ID（数据库用户ID由注册数据库用户接口创建）。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字、中划线组成，且长度为36个字符的UUID。 默认取值： 不涉及。

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 version ApiVersion object 参数解释： API版本详细信息列表。 取值范围： 不涉及。 表3 ApiVersion 参数 参数类型 描述 id String 参数解释： API版本号，如v3。 取值范围： 不涉及。 status String 参数解释： 版本状态。 取值范围： CURRENT：主推版本。 SUPPORTED：老版本，但是现在还继续支持。 DEPRECATED：废弃版本，存在后续删除的可能。 updated String 参数解释： 版本发布时间。 格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指UTC时间。 取值范围： 不涉及。 version String 参数解释： API的微版本，如果不支持微版本，则为空。 取值范围： 不涉及。

请求示例 获取实例健康诊断报告内容。 GET https://das.cn-north-7.myhuaweicloud.com/v3/052041494800d57c2f02c00275b4c247/instances/bcfa975193f1402fa11a6d4fd6baf5fbin01/get-instance-health-report?task_id=bb252ed0-3d06-489a-a662-6609e054e91c

响应示例 状态码： 200 Success. { "success" : true, "summary_info" : { "analysis_results" : [ { "risk_code" : "SLOW_ LOG _ISSUE", "risk_level" : "WARNING", "risk_content" : "慢SQL问题", "reasons" : [ { "reason_code" : "SLOW_LOG_EXIST", "reason_content" : "存在慢SQL", "suggestions" : [ { "suggestion_code" : "ANALYZE_SLOW_LOG", "suggestion_content" : "分析慢SQL查找问题根源" } ] } ] } ] }, "instance_info" : { "tenant_id" : "05204146e600d48f0f02c002850ec340", "project_id" : "052041494800d57c2f02c00275b4c247", "instance_id" : "bcfa975193f1402fa11a6d4fd6baf5fbin01", "instance_name" : "rds-sql-勿删1", "cpu" : 2, "mem" : 8, "disk_size" : 60, "disk_type" : "CLOUDSSD", "engine" : "mysql", "engine_version" : "5.7" }, "performance_stat" : { "analyze_success" : true, "peak_stats" : [ { "metric" : "qps", "value" : 64.88, "max_value" : 11178, "normalized" : 0.005804258364644837, "stage" : "LIGHT", "timestamp" : 1728756000 } ], "ratio_stats" : [ { "metric" : "qps", "max_value" : 11178, "critical_ratio" : 0, "medium_ratio" : 0, "light_ratio" : 1 } ] }, "disk_stat" : { "analyze_success" : true, "peak_stats" : [ { "metric" : "iops", "value" : 91.9, "max_value" : 4500, "normalized" : 0.020422222222222224, "stage" : "LIGHT", "timestamp" : 1728750600 } ], "ratio_stats" : [ { "metric" : "iops", "max_value" : 4500, "critical_ratio" : 0, "medium_ratio" : 0, "light_ratio" : 1 } ] }, "table_space_stat" : { "analyze_success" : true }, "slow_log_stat" : { "analyze_success" : true, "collect_slow_log" : true, "top_execute_slow_logs" : [ { "template_id" : "5B20B6BF446F926F", "template" : "INSERT INTO test123 VALUES (?);", "databases" : [ "test_db" ], "times" : 83, "avg_query_time" : 0.9021538595657752, "max_query_time" : 45.08398997783661, "avg_rows_examined" : 0, "sum_rows_examined" : 0, "avg_rows_sent" : 0 } ], "rows_examined_exceeding" : [ ] }, "full_sql_stat" : { "analyze_success" : true, "collect_full_sql" : true, "execute_top_templates" : [ { "template_id" : "B38F825636B24B7", "template" : "CREATE TABLE IF NOT EXISTS table_001 (id int)", "databases" : [ "test_db" ], "times" : 1, "avg_query_time" : 5, "avg_rows_examined" : 0, "sum_rows_examined" : 0 } ] }, "inspection_stat" : { "analyze_success" : true, "inspection_score" : [ { "score" : 100, "critical" : 0, "medium" : 0, "light" : 0, "cpu_usage" : 3.93, "mem_usage" : 22.91, "space_usage" : 8.66, "connection_rate" : 0.54, "iops_usage" : 0.28, "thread_running" : 4, "slow_sql_total" : 0, "lost_points_detail_list" : [ { "metric" : "memUsage", "lost_points" : 0, "risk_level" : "NORMAL" }, { "metric" : "cpuUsage", "lost_points" : 0, "risk_level" : "NORMAL" }, { "metric" : "spaceUsage", "lost_points" : 0, "risk_level" : "NORMAL" }, { "metric" : "iopsUsage", "lost_points" : 0, "risk_level" : "NORMAL" }, { "metric" : "connectionRate", "lost_points" : 0, "risk_level" : "NORMAL" }, { "metric" : "threadRunning", "lost_points" : 0, "risk_level" : "NORMAL" }, { "metric" : "slowSqlTotal", "lost_points" : 0, "risk_level" : "NORMAL" } ] } ] } }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 success Boolean 参数解释： 日报诊断是否成功。 取值范围： 不涉及。 start_at Long 参数解释： 日报诊断区间的起始时间（Unix timestamp），单位：毫秒。 取值范围： 不涉及。 end_at Long 参数解释： 日报诊断区间的结束时间（Unix timestamp），单位：毫秒。 取值范围： 不涉及。 task_id String 参数解释： 报告ID。 取值范围： 不涉及。 summary_info 表4 object 参数解释： 日报内容摘要信息 取值范围： 不涉及。 instance_info 表8 object 参数解释： 实例信息列表。 取值范围： 不涉及。 performance_stat 表9 object 参数解释： 性能统计分析列表。 取值范围： 不涉及。 disk_stat 表10 object 参数解释： 磁盘统计分析列表。 取值范围： 不涉及。 table_space_stat 表13 object 参数解释： 表空间统计分析列表。 取值范围： 不涉及。 slow_log_stat 表16 object 参数解释： 慢SQL统计分析列表。 取值范围： 不涉及。 full_sql_stat 表17 object 参数解释： 全量SQL统计分析列表。 取值范围： 不涉及。 inspection_stat 表19 object 参数解释： 巡检评分统计分析列表。 取值范围： 不涉及。 error_message String 参数解释： 错误信息。 取值范围： 不涉及。 表4 HealthReportSummaryInfo 参数 参数类型 描述 analysis_results Array of 表5 objects 参数解释： 分析结果列表。 取值范围： 不涉及。 表5 HealthReportAnalysisResult 参数 参数类型 描述 risk_code String 参数解释： 风险点编码。 取值范围： 不涉及。 risk_level String 参数解释： 风险点级别。 取值范围： 不涉及。 risk_content String 参数解释： 风险点内容。 取值范围： 不涉及。 reasons Array of 表6 objects 参数解释： 可能原因列表。 取值范围： 不涉及。 表6 HealthReportRiskReason 参数 参数类型 描述 reason_code String 参数解释： 可能原因编码。 取值范围： 不涉及。 reason_content String 参数解释： 可能原因内容。 取值范围： 不涉及。 suggestions Array of 表7 objects 参数解释： 建议优化措施列表。 取值范围： 不涉及。 表7 HealthReportRiskSuggestion 参数 参数类型 描述 suggestion_code String 参数解释： 建议优化措施编码。 取值范围： 不涉及。 suggestion_content String 参数解释： 建议优化措施。 取值范围： 不涉及。 表8 HealthReportInstanceInfo 参数 参数类型 描述 tenant_id String 参数解释： 账号ID。 取值范围： 不涉及。 project_id String 参数解释： 项目ID。 取值范围： 不涉及。 instance_id String 参数解释： 实例ID。 取值范围： 不涉及。 master_node_id String 参数解释： 主节点ID。 取值范围： 不涉及。 instance_name String 参数解释： 实例名称。 取值范围： 不涉及。 cpu Integer 参数解释： 实例cpu核数。 取值范围： 不涉及。 mem Integer 参数解释： 实例内存大小。 取值范围： 不涉及。 disk_size Integer 参数解释： 磁盘大小。 取值范围： 不涉及。 disk_type String 参数解释： 磁盘类型。 取值范围： 不涉及。 engine String 参数解释： 实例引擎类型。 取值范围： 不涉及。 engine_version String 参数解释： 引擎内核版本。 取值范围： 不涉及。 表9 HealthReportPerformanceStat 参数 参数类型 描述 peak_stats Array of 表11 objects 参数解释： 峰值统计信息列表。 取值范围： 不涉及。 ratio_stats Array of 表12 objects 参数解释： 比率值数据列表。 取值范围： 不涉及。 analyze_success Boolean 参数解释： 统计分析是否成功。 取值范围： 不涉及。 error_message String 参数解释： 错误信息。 取值范围： 不涉及。 表10 HealthReportDiskStat 参数 参数类型 描述 peak_stats Array of 表11 objects 参数解释： 峰值统计信息列表。 取值范围： 不涉及。 ratio_stats Array of 表12 objects 参数解释： 比率值数据列表。 取值范围： 不涉及。 analyze_success Boolean 参数解释： 统计分析是否成功。 取值范围： 不涉及。 error_message String 参数解释： 错误信息。 取值范围： 不涉及。 表11 HealthReportSingleValueStat 参数 参数类型 描述 metric String 参数解释： 指标名。 取值范围： 不涉及。 value Double 参数解释： 数值。 取值范围： 不涉及。 max_value Double 参数解释： 最大值。 取值范围： 不涉及。 normalized Double 参数解释： 归一化值。 取值范围： 不涉及。 stage String 参数解释： 当前状态。 取值范围： 不涉及。 timestamp Long 参数解释： 指标采集时间。 取值范围： 不涉及。 表12 HealthReportRatioStat 参数 参数类型 描述 metric String 参数解释： 指标名。 取值范围： 不涉及。 max_value Double 参数解释： 最大值。 取值范围： 不涉及。 critical_ratio Double 参数解释： 高水位占比。 取值范围： 不涉及。 medium_ratio Double 参数解释： 中水位占比。 取值范围： 不涉及。 light_ratio Double 参数解释： 低水位占比。 取值范围： 不涉及。 表13 HealthReportTableSpaceStat 参数 参数类型 描述 size_top Array of 表14 objects 参数解释： 表大小Top列表。 取值范围： 不涉及。 rows_top Array of 表14 objects 参数解释： 表行数量Top列表。 取值范围： 不涉及。 size_incr_top Array of 表15 objects 参数解释： 表大小增长Top列表。 取值范围： 不涉及。 rows_incr_top Array of 表15 objects 参数解释： 表行数量增长Top列表。 取值范围： 不涉及。 analyze_success Boolean 参数解释： 统计分析是否成功。 取值范围： 不涉及。 error_message String 参数解释： 错误信息。 取值范围： 不涉及。 表14 HealthReportTableSpaceInfo 参数 参数类型 描述 database String 参数解释： 数据库名。 取值范围： 不涉及。 table String 参数解释： 表名。 取值范围： 不涉及。 db_engine String 参数解释： 数据库引擎。 取值范围： 不涉及。 table_size Long 参数解释： 表大小。 取值范围： 不涉及。 data_size Long 参数解释： 数据大小。 取值范围： 不涉及。 index_size Long 参数解释： 索引大小。 取值范围： 不涉及。 rows Long 参数解释： 行数量。 取值范围： 不涉及。 表15 HealthReportTableSpaceIncrInfo 参数 参数类型 描述 database String 参数解释： 数据库名。 取值范围： 不涉及。 table String 参数解释： 表名。 取值范围： 不涉及。 increment Long 参数解释： 增长量。 取值范围： 不涉及。 analyze_success Boolean 参数解释： 统计分析是否成功。 取值范围： 不涉及。 error_message String 参数解释： 错误信息。 取值范围： 不涉及。 表16 HealthReportSlowLogStat 参数 参数类型 描述 collect_slow_log Boolean 参数解释： 是否收集慢SQL。 取值范围： 不涉及。 top_execute_slow_logs Array of 表18 objects 参数解释： 慢SQL Top执行次数列表。 取值范围： 不涉及。 top_avg_query_time_slow_logs Array of 表18 objects 参数解释： 慢SQL Top平均执行时间列表。 取值范围： 不涉及。 top_max_query_time_slow_logs Array of 表18 objects 参数解释： 慢SQL Top最大执行时间列表。 取值范围： 不涉及。 rows_examined_exceeding Array of 表18 objects 参数解释： 慢SQL Top扫描返回比列表。 取值范围： 不涉及。 analyze_success Boolean 参数解释： 统计分析是否成功。 取值范围： 不涉及。 error_message String 参数解释： 错误信息。 取值范围： 不涉及。 表17 HealthReportFullSqlStat 参数 参数类型 描述 collect_full_sql Boolean 参数解释： 是否收集全量SQL。 取值范围： 不涉及。 execute_top_templates Array of 表18 objects 参数解释： 全量SQL Top总执行次数列表。 取值范围： 不涉及。 sum_rows_examined_top_templates Array of 表18 objects 参数解释： 全量SQL Top总扫描行数列表。 取值范围： 不涉及。 avg_cost_top_templates Array of 表18 objects 参数解释： 全量SQL Top平均执行耗时列表。 取值范围： 不涉及。 analyze_success Boolean 参数解释： 统计分析是否成功。 取值范围： 不涉及。 error_message String 参数解释： 错误信息。 取值范围： 不涉及。 表18 HealthReportSqlTemplate 参数 参数类型 描述 template_id String 参数解释： 模板ID。 取值范围： 不涉及。 template String 参数解释： 模板内容。 取值范围： 不涉及。 databases Array of strings 参数解释： 数据库列表。 取值范围： 不涉及。 times Long 参数解释： 执行次数。 取值范围： 不涉及。 avg_query_time Double 参数解释： 平均执行时间。 取值范围： 不涉及。 max_query_time Double 参数解释： 最大执行时间。 取值范围： 不涉及。 avg_rows_examined Double 参数解释： 平均扫描行数。 取值范围： 不涉及。 max_rows_examined Double 参数解释： 最大扫描行数。 取值范围： 不涉及。 sum_rows_examined Double 参数解释： 总扫描行数。 取值范围： 不涉及。 avg_rows_sent Double 参数解释： 平均返回行数。 取值范围： 不涉及。 max_rows_sent Double 参数解释： 最大返回行数。 取值范围： 不涉及。 表19 HealthReportInspectionStat 参数 参数类型 描述 inspection_score Array of 表20 objects 参数解释： 巡检评分。 取值范围： 不涉及。 analyze_success Boolean 参数解释： 统计分析是否成功。 取值范围： 不涉及。 error_message String 参数解释： 错误信息。 取值范围： 不涉及。 表20 HealthReportInspectionScore 参数 参数类型 描述 score Double 参数解释： 得分。 取值范围： 不涉及。 critical Integer 参数解释： 严重事件。 取值范围： 不涉及。 medium Integer 参数解释： 警告事件。 取值范围： 不涉及。 light Integer 参数解释： 优化事件。 取值范围： 不涉及。 cpu_usage Double 参数解释： CPU使用率。 取值范围： 不涉及。 mem_usage Double 参数解释： 内存使用率。 取值范围： 不涉及。 space_usage Double 参数解释： 空间使用率。 取值范围： 不涉及。 connection_rate Double 参数解释： 连接使用率。 取值范围： 不涉及。 iops_usage Double 参数解释： IOPS使用率。 取值范围： 不涉及。 thread_running Double 参数解释： 活跃会话。 取值范围： 不涉及。 slow_sql_total Long 参数解释： 慢SQL数量。 取值范围： 不涉及。 lost_points_detail_list Array of 表21 objects 参数解释： 扣分详情。 取值范围： 不涉及。 表21 HealthReportLostPointsDetail 参数 参数类型 描述 metric String 参数解释： 扣分项。 取值范围： 不涉及。 lost_points Double 参数解释： 所扣分数。 取值范围： 不涉及。 risk_level String 参数解释： 事件等级。 取值范围： 不涉及。

URI GET /v3/{project_id}/instances/{instance_id}/get-instance-health-report 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 instance_id 是 String 参数解释： 实例ID。标识实例的唯一标识。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 表2 Query参数 参数 是否必选 参数类型 描述 task_id 是 String 参数解释： 任务ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

请求示例 创建实例健康诊断任务。 POST https://das.cn-north-7.myhuaweicloud.com/v3/052041494800d57c2f02c00275b4c247/instances/bcfa975193f1402fa11a6d4fd6baf5fbin01/create-instance-health-report-task { "start_at" : 1728103093329, "end_at" : 1729103093329 }

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 start_at 是 Long 参数解释： 开始时间（Unix timestamp），单位：毫秒。 约束限制： 不涉及。 取值范围： [0, 2^31-1]，实际取决于查询。 默认取值： 不涉及。 end_at 是 Long 参数解释： 结束时间（Unix timestamp），单位：毫秒。 约束限制： 不涉及。 取值范围： [0, 2^31-1]，实际取决于查询。 默认取值： 不涉及。

URI POST /v3/{project_id}/instances/{instance_id}/create-instance-health-report-task 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 instance_id 是 String 参数解释： 实例ID。标识实例的唯一标识。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。

请求示例 删除共享链接。 DELETE https://{{endpoint}}/v3/{{project_id}}/connections/share { "users" : [ { "user_id" : "0852a89ae180d5401f5ac00271a4a02e", "user_name" : "username1" }, { "user_id" : "07da4af00180d5651f49c00200b352b5", "user_name" : "username2" } ], "shared_conn_id" : "ee64e597-4f25-486f-bba1-0c850b3b59d6" }

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 shared_conn_id 是 String 参数解释： 共享连接ID。用户使用数据库账号与数据库建立的连接ID（数据库用户ID由创建实例连接接口创建）。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字、中划线组成，且长度为36个字符的UUID。 默认取值： 不涉及 users 是 Array of ShareConnUserInfo objects 参数解释： 用户。 约束限制： 可组合，用逗号分隔。 取值范围： 不涉及。 默认取值： 不涉及。 表3 ShareConnUserInfo 参数 是否必选 参数类型 描述 user_id 是 String 参数解释： 用户ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 user_name 是 String 参数解释： 用户名。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

URI POST /v3/{project_id}/instances/{instance_id}/create-connection 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 instance_id 是 String 参数解释： 实例ID。标识实例的唯一标识。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 engine_type 是 String 参数解释： 数据库引擎类型。 约束限制： 不涉及。 取值范围： mysql sqlserver postgresql taurus gaussdbv5 mongodb ddm 默认取值： 不涉及。 network_type 是 String 参数解释： 数据库来源类型。 约束限制： 不涉及。 取值范围： rds gaussdb dds ddm 默认取值： 不涉及。 username 是 String 参数解释： 用户名。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 is_save_password 是 Boolean 参数解释： 是否保存密码。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 password 是 String 参数解释： 密码。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 node_ids 否 Array of strings 参数解释： 节点ID。标识实例节点的唯一标识。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 remarks 否 String 参数解释： 备注。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 port 否 Integer 参数解释： 端口。 约束限制： 不涉及。 取值范围： [1,65536] 默认取值： 不涉及。 database_name 否 String 参数解释： 数据库名字。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 sql_record_flag 否 Boolean 参数解释： sql记录开关。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

请求示例 创建实例连接。 POST https://das.cn-north-7.myhuaweicloud.com/v3/052041494800d57c2f02c00275b4c247/instances/bcfa975193f1402fa11a6d4fd6baf5fbin01/create-connection { "engine_type" : "mysql", "network_type" : "rds", "username" : "root", "is_save_password" : true, "password" : "Gauss_2345", "sql_record_flag" : true, "remarks" : "create by api" }

响应示例 状态码： 200 Success. { "tasks": [ { "id": 1128, "instance_id": "da304cd5bbb944de828759bc7be3d3fein01", "start_at": 1738717200000, "end_at": 1738720800000, "status": 2, "progress": 100, "create_at": 1738740285113, "update_at": 1738740294826 } ], "total": 1 }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 tasks Array of 表4 objects 参数解释： SQL洞察任务列表。 取值范围： 不涉及。 total Integer 参数解释： 总数。 取值范围： 不涉及。 表4 FullSqlTask 参数 参数类型 描述 id Long 参数解释： 任务ID。 取值范围： 不涉及。 instance_id String 参数解释： 实例ID。 取值范围： 不涉及。 instance_name String 参数解释： 实例名称。 取值范围： 不涉及。 node_id String 参数解释： 节点ID。 取值范围： 不涉及。 start_at Long 参数解释： 开始时间（Unix timestamp），单位：毫秒。 取值范围： 不涉及。 end_at Long 参数解释： 结束时间（Unix timestamp），单位：毫秒。 取值范围： 不涉及。 batch_id String 参数解释： 批次ID。 取值范围： 不涉及。 user_list Array of strings 参数解释： 用户名。 取值范围： 不涉及。 keyword Array of strings 参数解释： 关键字。 取值范围： 不涉及。 db_list Array of strings 参数解释： 数据库。 取值范围： 不涉及。 operation_list Array of strings 参数解释： 操作类型。 取值范围： 不涉及。 thread_id_list Array of strings 参数解释： 线程ID。 取值范围： 不涉及。 trx_id_list Array of strings 参数解释： 事务ID。 取值范围： 不涉及。 status_list Array of strings 参数解释： 执行状态。 取值范围： 0：成功 1：失败 sql_template_ids Array of strings 参数解释： SQL模板ID。 取值范围： 不涉及。 status Integer 参数解释： 任务状态。 取值范围： 0：等待解析 1：解析中 2：解析完成 -1：失败。 progress Double 参数解释： 任务进度。 取值范围： [0,100] reason String 参数解释： 失败原因。 取值范围： 不涉及。 create_at Long 参数解释： 创建时间（Unix timestamp），单位：毫秒。 取值范围： 不涉及。 update_at Long 参数解释： 更新时间（Unix timestamp），单位：毫秒。 取值范围： 不涉及。

URI GET /v3/{project_id}/instances/{instance_id}/full-sql-tasks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 instance_id 是 String 参数解释： 实例ID。标识实例的唯一标识。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 表2 Query参数 参数 是否必选 参数类型 描述 range_left 否 Long 参数解释： 最小任务起止时间。 约束限制： Unix timestamp，单位：毫秒。 取值范围： [0, 2^31-1]，实际取决于查询。 默认取值： 不涉及。 range_right 否 Long 参数解释： 最大任务起止时间。 约束限制： Unix timestamp，单位：毫秒。 取值范围： [0, 2^31-1]，实际取决于查询。 默认取值： 不涉及。 create_at_left 否 Long 参数解释： 最小任务创建时间。 约束限制： Unix timestamp，单位：毫秒。 取值范围： [0, 2^31-1]，实际取决于查询。 默认取值： 不涉及。 create_at_right 否 Long 参数解释： 最大任务创建时间。 约束限制： Unix timestamp，单位：毫秒。 取值范围： [0, 2^31-1]，实际取决于查询。 默认取值： 不涉及。 user 否 String 参数解释： 用户名 约束限制： 可组合，用逗号分隔。 取值范围： 不涉及。 默认取值： 不涉及。 keyword 否 String 参数解释： 关键字。 约束限制： 可组合，用逗号分隔。 取值范围： 不涉及。 默认取值： 不涉及。 db_name 否 String 参数解释： 数据库名。 约束限制： 可组合，用逗号分隔。 取值范围： 不涉及。 默认取值： 不涉及。 operation 否 String 参数解释： 操作类型 约束限制： 可组合，用逗号分隔。 取值范围： 不涉及。 默认取值： 不涉及。 thread_id 否 String 参数解释： 线程ID 约束限制： 可组合，用逗号分隔。 取值范围： 不涉及。 默认取值： 不涉及。 trx_id 否 String 参数解释： 事务ID 约束限制： 可组合，用逗号分隔。 取值范围： 不涉及。 默认取值： 不涉及。 status 否 String 参数解释： 执行状态 约束限制： 可组合，用逗号分隔。 取值范围： 0：成功 1：失败 默认取值： 不涉及。 sql_template_id 否 String 参数解释： SQL模板ID 约束限制： 可组合，用逗号分隔。 取值范围： 不涉及。 默认取值： 不涉及。 sort_field 否 String 参数解释： 排序字段。 create_at：任务创建时间 range_start_at，range_end_at：任务起止时间 约束限制： 不涉及。 取值范围： create_at：任务创建时间 range_start_at，range_end_at：任务起止时间 默认取值： 不涉及。 asc 否 Boolean 参数解释： 排序顺序。 约束限制： 不涉及。 取值范围： true：正序 false：逆序 默认取值： 不涉及。 page 否 Integer 参数解释： 页码。 约束限制： 不涉及。 取值范围： [0, 2^31-1]，实际取决于查询。 默认取值： 不涉及。 limit 否 Integer 参数解释： 每页记录数。 约束限制： 不涉及。 取值范围： [0, 100]，实际取决于查询。 默认取值： 不涉及。

响应参数 状态码： 200 表1 响应Body参数 参数 参数类型 描述 versions Array of ApiVersion objects 参数解释： API版本详细信息列表。 取值范围： 不涉及。 表2 ApiVersion 参数 参数类型 描述 id String 参数解释： API版本号，如v3。 取值范围： 不涉及。 status String 参数解释： 版本状态。 取值范围： CURRENT：主推版本。 SUPPORTED：老版本，但是现在还继续支持。 DEPRECATED：废弃版本，存在后续删除的可能。 updated String 参数解释： 版本发布时间。 格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指UTC时间。 取值范围： 不涉及。 version String 参数解释： API的微版本，如果不支持微版本，则为空。 取值范围： 不涉及。