华为云用户手册

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

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

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

请求示例 修改指定实例的参数。 https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/configurations { "values" : { "max_connections" : "10", "autocommit" : "OFF", "binlog_checksum" : "CRC32", "innodb_purge_threads" : "4" } }

响应消息 正常响应要素说明 表3 要素说明 名称 参数类型 说明 job_id String 参数解释： 任务ID。 取值范围： 不涉及。 restart_required Boolean 参数解释： 实例是否需要重启。 取值范围： “true”需要重启。 “false”不需要重启。 ignored_params List 参数解释： 请求参数“values”中被忽略掉，没有生效的参数名称列表。 当参数不存在时，参数修改不会下发，并通过此参数返回所有被忽略的参数名称。 取值范围： 不涉及。 正常响应样例 { "job_id" : "e7a7535b-eb9b-45ac-a83a-020dc5016d94", "restart_required" : "false", "ignored_params": [] } 异常响应 请参见异常请求结果。

请求示例 变更FlexusRDS数据库实例的规格为rds.mysql.m1.xlarge。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action { "resize_flavor": { "spec_code": "rds.mysql.m1.xlarge", "is_auto_pay": true, "is_delay": true } }

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 resize_flavor 是 Object 参数解释： 规格信息。请参见表3。 约束限制： 不涉及。 表3 resize_flavor字段数据结构说明 名称 是否必选 参数类型 说明 spec_code 是 String 参数解释： 资源规格编码。 约束限制： 不涉及。 取值范围： 例如：rds.mysql.y1.xlarge.2。其中，rds代表RDS产品，mysql代表数据库引擎，y1.xlarge代表性能规格，为轻量型规格。 默认取值： 不涉及。 is_auto_pay 否 Boolean 参数解释： 是否自动从客户的账户中支付。 约束限制： 不涉及。 取值范围： true，为自动支付。 false，为手动支付，默认该方式。 默认取值： 不涉及。 is_delay 否 Boolean 参数解释： 是否进行定时规格变更。 约束限制： 不涉及。 取值范围： true，为定时变更，将在运维时间窗内进行变更操作。 false，为即时变更，默认该方式。 默认取值： 不涉及。

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

AK/SK认证 AK/SK签名认证方式仅支持消息体大小12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK(Access Key ID)：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK(Secret Access Key)：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxx" } } } } 在构造请求中以调用获取用户Token接口为例说明了如何调用API。 获取Token 后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 1 2 3 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333 。

概述 欢迎使用Flexus云数据库RDS。Flexus云数据库RDS是基于开源MySQL内核，轻量化规格，便捷运维，开箱即用的轻量级数据库；整体上属于RDS for MySQL产品序列。华为云通过技术创新，为初创企业及个人学习等客户提供轻量级数据库服务。便于客户快速入手使用数据库，助力客户聚焦业务，加快业务快速发展，减少非核心精力投入。 您可以使用本文档提供API对数据库实例进行相关操作，如创建、备份恢复、参数配置等。支持的全部操作请参见API概览。 父主题： 使用前必读

调用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": "project_name", "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" } }

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

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 switch_option Boolean 参数解释： 是否开启自动扩容。 取值范围： true为开启。 false为关闭。 limit_size Integer 参数解释： 扩容上限，单位GB。 取值范围： 40GB~4000GB。 trigger_threshold Integer 参数解释： 可用存储空间百分比，小于等于此值或者为10GB时触发扩容。 取值范围： 枚举值： 10 15 20 step_percent Integer 参数解释： 每次自动扩容的步长，单位为百分比，即每次自动扩容当前存储空间的百分比。 取值范围： 5%~50% 正常响应样例 开启自定义步长功能时查询到的自动扩容策略。 { "switch_option" : true, "limit_size" : 4000, "trigger_threshold" : 10, "step_percent" : 30 } 异常响应 请参见异常请求结果。

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

请求示例 创建FlexusRDS实例的手动备份mybackup。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/backups { "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01", "name": "mybackup", "description": "manual backup" }

欠费影响 由于特惠包是先付费再使用方式，所以在您特惠包的订单到期或即将到期时，请及时续费。如果不及时续费，可能影响您的使用。 表1 不同阶段欠费影响 - 账户余额充足 账户余额不足或欠费 APM 状态 可正常使用APM 冻结，不再采集并展示欠费后的应用数据，但之前的数据仍可展示、查询。 续费说明 此期间续订特惠包，可正常使用APM。 如果充值，APM自动解除冻结，按需计费。如果您需要特惠包，需要重新续订或购买。否则，APM按需计费。如何续费请参见如何续费 如果不续订特惠包，APM自动将收费方式转为按需计费。 如果不充值，超出保留期后，所有资源被释放，此期间APM不计费。

欠费影响 由于特惠包是先付费再使用方式，所以在您特惠包的订单到期或即将到期时，请及时续费。如果不及时续费，可能影响您的使用。 表1 不同阶段欠费影响 - 账户余额充足 账户余额不足或欠费 APM状态 可正常使用APM 冻结，不再采集并展示欠费后的应用数据，但之前的数据仍可展示、查询。 续费说明 此期间续订特惠包，可正常使用APM。 如果充值，APM自动解除冻结，按需计费。如果您需要特惠包，需要重新续订或购买。否则，APM按需计费。如何续费请参见如何续费。 如果不续订特惠包，APM自动将收费方式转为按需计费。 如果不充值，超出保留期后，所有资源被释放，此期间APM不计费。

Spark 3.3.1版本说明 表1列举了Spark 3.3.1 版本主要的功能特性。 更多版本新特性及性能优化请参考Release Notes - Spark 3.3.1。 表1 Spark 3.3.1版本优势 特性 说明 Native性能加速 Spark查询语句性能提升。 元数据访问性能提升 提升Spark在处理大数据时的元数据访问性能，提高数据处理流程效率。 提升OBS committer小文件写性能 提升 对象存储服务 （OBS）在处理小文件写入时的性能，提高数据传输效率。 动态Executor shuffle数据优化 提升资源扩缩容的稳定性，当shuffle文件不需要时清理Executor。 支持配置小文件合并 使用SQL过程中，生成的小文件过多时，会导致作业执行时间过长，且查询对应表时耗时增大，建议对小文件进行合并。 参考如何合并小文件完成合并小文件。 支持修改非分区表或分区表的列注释 修改非分区表或分区表的列注释。 支持统计SQL作业的CPU消耗 支持在控制台查看“CPU累计使用量”。 支持容器集群Spark日志跳转查看 需要在容器查看日志。 支持动态加载UDF（公测） 无需重启队列UDF即可生效。 Spark UI支持火焰图 Spark UI支持绘制火焰图。 优化SQL作业NOT IN语句查询性能 NOT IN语句查询性能提升。 优化Multi-INSERT语句查询性能 Multi-INSERT语句查询性能提升。

Spark 2.4.5 版本说明 表1列举了Spark 2.4.5 版本主要的功能特性。 更多版本新特性请参考Release Notes - Spark 3.1.1。 表1 Spark 2.4.5版本优势 特性 说明 支持配置小文件合并 使用SQL过程中，生成的小文件过多时，会导致作业执行时间过长，且查询对应表时耗时增大，建议对小文件进行合并。 参考如何合并小文件完成合并小文件。 支持修改非分区表或分区表的列注释 修改非分区表或分区表的列注释。 支持统计SQL作业的CPU消耗 支持在控制台查看“CPU累计使用量”。 支持容器集群Spark日志跳转查看 需要在容器查看日志。 支持动态加载UDF（公测） 无需重启队列UDF即可生效。 Spark UI支持火焰图 Spark UI支持绘制火焰图。 优化SQL作业NOT IN语句查询性能 NOT IN语句查询性能提升。 优化Multi-INSERT语句查询性能 Multi-INSERT语句查询性能提升。

影响 DLI Flink 1.7版本停止服务（EOS）后，不再提供该软件版本相关的任何技术服务支持。建议您在执行作业时选择新版本的Flink引擎，推荐使用DLI Flink 1.12版本。 正在使用Flink 1.7版本的作业也请您尽快切换至新版本的Flink引擎，否则作业执行过程中出现的错误，不再提供该版本的任何技术服务支持。 如您有任何问题，可随时通过工单或者服务热线（4000-955-988或950808）与我们联系。

影响 DLI Spark 2.3.2版本停止服务（EOS）后，不再提供该软件版本的任何技术服务支持。建议您在执行作业时选择新版本的Spark引擎，推荐使用DLI Spark 2.4.5版本。 正在使用DLI Spark 2.3.2版本的作业也请您尽快切换至新版本的Spark引擎，否则作业执行过程中出现的错误，不再提供该版本的任何技术服务支持。 如您有任何问题，可随时通过工单或者服务热线（4000-955-988或950808）与我们联系。

影响 EOM后，不再支持新购队列资源，包括不支持新购“包年/包月”和“按需计费”计费模式队列和“队列CU时套餐包”。 为了满足部分业务的使用需求，在2024年6月30日 00:00:00（北京时间）前，您可以最大续订1年队列或者变更队列。 2024年6月30日 00:00:00（北京时间）之后将无法续订、变更队列。 EOL后，队列资源将无法继续使用，请务必在下线前更换使用“弹性资源池”或“default队列”。推荐您购买弹性资源池，并在弹性资源池中创建队列，体验更丰富的DLI产品能力。 如您有任何问题，可随时通过工单或者服务热线（4000-955-988或950808）与我们联系。

公告说明 为了更好的实现资源共享，提高计算资源利用率，DLI将“包年/包月”和“按需计费”计费模式队列升级为“弹性资源池队列”。即使用DLI计算资源需先购买弹性资源池，并在弹性资源池中创建队列。 DLI“包年/包月”和“按需计费”计费模式队列和“队列CU时套餐包”计划于2024年3月31日 00:00（北京时间）停止销售（EOM）。 DLI“包年/包月”和“按需计费”计费模式队列和“队列CU时套餐包”计划于2025年6月30日 00:00（北京时间）下线（EOL）。

Spark 3.1.1版本说明 下表列举了Spark 3.1.1 版本主要的功能特性。 更多版本新特性请参考Release Notes - Spark 3.1.1。 【SPARK-33050】：Apache ORC升级到1.5.12。 【SPARK-33092】：增强子表达式消减。 【SPARK-33480】：支持char/varchar数据类型。 【SPARK-32302】: 部分谓词下推优化。 【SPARK-30648】：支持JSON datasource表谓词下推。 【SPARK-32346】：支持avro datasource表谓词下推 。 【SPARK-32461】：shuffle hash join优化。 【SPARK-32272】：添加SQL标准命令SET TIME ZONE。 【SPARK-21492】：修复排序合并加入中的内存泄漏。 【SPARK-27812】：K8S客户端版本提升到4.6.1。 DLI从Spark 3.x版本开始不支持内置地理空间查询函数。

暴力破解防护限制 使用鲲鹏计算EulerOS（EulerOS with ARM）操作系统的主机，在遭受SSH账户破解攻击时，HSS不会对攻击IP进行拦截，仅支持对攻击行为进行告警。 为Windows主机开启防护时，需要授权开启Windows防火墙，且使用主机安全服务期间请勿关闭Windows防火墙。 如果关闭Windows防火墙，HSS无法拦截账户暴力破解的攻击源IP；即使手动关闭后开启Windows防火墙，也可能导致HSS不能拦截账户暴力破解的攻击源IP。

涉及接口 用户用例操作包括，创建测试用例、更新测试用例、批量删除测试用例、获取测试用例详情、批量执行用例接口、批量更新测试用例结果，涉及接口如下： 创建自定义测试服务类型用例：新建用例进行测试。 更新自定义测试服务类型用例：修改用例信息。 批量删除自定义测试服务类型用例：可同时删除多个用例。 获取测试用例详情：单个查询用例详情。 批量执行测试用例：同时执行多个测试用例。 批量更新测试用例结果：用例结果产生后，同时更新多个测试用例结果。

后端服务调用报错 域名 无法解析“Backend domain name resolution failed” APIG实例所在的VPC完成了内网域名解析，后端服务调用仍报“域名无法解析”错误。 可能原因 APIG实例所在的VPC与用户后端服务所在的VPC存在网络隔离，内网域名解析仅在用户后端服务所在的VPC下能够解析。 解决方法 方法一：在创建API时，使用公网域名配置“后端服务地址”。 方法二：在创建API时，不使用VPC通道（负载通道），使用用户后端服务IP配置“后端服务地址”，添加常量参数，在HEADER中添加Host：域名字段。 方法三：在创建API时，使用VPC通道（负载通道）。 创建VPC通道（负载通道）。 添加用户后端服务地址。 创建API时，使用VPC通道（负载通道），配置自定义头域。 父主题： API调用

响应示例 状态码： 200 响应成功示例 { "result" : "success", "data" : { "image_info" : { "objects" : [ { "box" : "26,223,771,704", "category" : 11, "category_name" : "electronics" } ] } } } 状态码： 400 响应失败示例 { "error_code" : "MMS.0003", "error_msg" : "Invalid parameter: item_id" }

请求示例 添加商品图像数据，使用图像BASE64编码 POST https://{endpoint}/v2/{project_id}/mms/{service_name}/data/add { "item_id" : "electronics_01", "image_base64" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA...", "desc" : "天地纵横自然", "custom_tags" : { "brand" : "HUAWEI" }, "custom_num_tags" : { "year" : 2022 } }