华为云用户手册

在线拨测按需 表3 在线拨测按需增值特性 计费方式 按需 适用场景 测试计划服务提供了在线拨测能力，提供7*24小时现网拨测，支持告警，实时看护及主动拨测式应用检测。 计费项 次数 购买限制 开通在线拨测按需，须完成CodeArts基础版及以上规格套餐或CodeArts TestPlan套餐的购买，购买的套餐到期后，在线拨测按需将无法继续使用。 计费公式 单价*次数。 计费场景 根据在线拨测的调用次数进行计费。计费的起点是您开通在线拨测按需的时间，终点则是到您关闭按需的时间，每天整点结算一次费用。 购买须知 当超出在线拨测按需套餐包的配额产生的用量，将自动转为按需付费。 当用户的账户余额不足以抵扣产生的按需费用，在线拨测功能将无法正常使用。 在线拨测按需套餐包不支持即时变更，支持关闭按需。

测试设计增值特性 表1 测试设计增值特性 计费方式 包年/包月 适用场景 测试计划服务提供了测试设计能力，包含启发式测试策略与设计、用例批量自动生成、支持Xmind导入生成用例、四层测试分解设计能力、优秀测试思维导图脑图模板等关键特性。 计费项 人数 购买限制 购买测试设计增值特性前，须完成CodeArts TestPlan套餐的购买，购买的套餐到期后，测试设计增值特性将无法继续使用。 购买人数需保持在Testplan套餐购买人数内。 计费公式 单价*人数*购买时长。 计费周期 根据购买时长确定（以GMT+8时间为准）。一个计费周期的起点是您开通或续费测试设计增值特性的时间（精确到秒），终点则是到期日的23:59:59。 例如，如果您在2023/03/08 15:50:04购买时长为一个月的测试设计增值特性，那么其计费周期为：2023/03/08 15:50:04 ~ 2023/04/08 23:59:59。 变更配置 测试设计增值特性支持变更配置，可以增加或减少人数，变更时系统将按照如下规则为您计算变更费用。 资源升配：变更后的人数高于变更前，此时您需要支付新老配置的差价。 资源降配：变更后的人数低于变更前，此时华为云会将新老配置的差价退给您 到期后影响 测试设计增值特性到期未续费时，测试设计相关能力将无法继续使用。

在线拨测按需套餐包 表2 在线拨测按需套餐包增值特性 计费方式 包年/包月 适用场景 测试计划服务提供了在线拨测能力，提供7*24小时现网拨测，支持告警，实时看护及主动拨测式应用检测。 计费项 套数 购买限制 购买在线拨测按需套餐包增值特性前，须完成CodeArts基础版及以上规格套餐或CodeArts TestPlan套餐的购买，购买的套餐到期后，在线拨测按需套餐包将无法继续使用。 计费公式 单价*购买数量*购买时长。 计费周期 根据购买时长确定（以GMT+8时间为准）。一个计费周期的起点是您开通或续费在线拨测按需套餐包增值特性的时间（精确到秒），终点则是到期日的23:59:59。 例如，如果您在2023/03/08 15:50:04购买时长为一个月的在线拨测按需套餐包增值特性，那么其计费周期为：2023/03/08 15:50:04 ~ 2023/04/08 23:59:59。 到期后影响 在线拨测按需套餐包增值特性到期未续费时，在线拨测相关能力会转到按需付费，请参考表3。 购买须知 在线拨测按需套餐包需要在开通按需付费的前提下使用，如果未开通按需，在线拨测能力将无法使用。 当超出在线拨测按需套餐包的配额产生的用量，将自动转为按需付费。 套餐包到期后资源不会自动关闭，将会以按需付费的方式继续使用。 套餐包可多次叠加购买（限购9999个），购买后不支持即时变更数量、时长，不能退订，请您确认好订单信息进行购买。

续费相关的功能 包年/包月测试计划服务续费相关的功能如表1所示。 表1 续费相关的功能 功能 说明 手动续费 包年/包月测试计划服务从购买到被自动删除之前，您可以随时在测试计划服务控制台进行续费，以延长使用时间。 自动续费 开通自动续费后，测试计划服务会在每次到期前自动续费，避免因忘记手动续费而导致资源被自动删除。 在包年/包月测试计划服务生命周期的不同阶段，您可以根据需要选择一种方式进行续费，具体如下图所示。 图1 测试计划服务生命周期 测试计划服务从购买到到期前，处于正常运行阶段，套餐状态为“正常”。 到期后，套餐状态变为“已过期”。 到期未续费时，测试计划服务首先会进入宽限期，宽限期到期后仍未续费，套餐状态变为“保留”。 超过宽限期仍未续费将进入保留期，如果保留期内仍未续费，资源将被自动删除。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 在测试计划服务到期前均可开通自动续费，到期前7日凌晨3:00首次尝试自动续费，如果扣款失败，每天凌晨3:00尝试一次，直至测试计划服务到期或者续费成功。到期前7日自动续费扣款是系统默认配置，您也可以根据需要修改此扣款日。

工作原理 当用户访问使用CDN服务的网站时，本地DNS服务器通过CNAME方式将最终 域名 请求重定向到CDN服务。CDN通过一组预先定义好的策略（如内容类型、地理区域、网络负载状况等），将当时能够最快响应用户的CDN节点IP地址提供给用户，使用户可以以最快的速度获得网站内容。使用CDN后的HTTP请求处理流程如下。 HTTP请求流程说明： 用户在浏览器输入要访问的网站域名www.example.com，向本地DNS发起域名解析请求。 本地DNS检查缓存中是否有www.example.com的IP地址记录。如果有，则直接返回给终端用户；如果没有，则向网站授权DNS查询。 网站DNS服务器解析发现域名已经解析到了CNAME：www.example.com.c.cdnhwc1.com。 请求被指向CDN服务。 CDN对域名进行智能解析，将响应速度最快的CDN节点IP地址返回给本地DNS。 用户获取响应速度最快的CDN节点IP地址。 浏览器在得到最佳节点的IP地址以后，向CDN节点发出访问请求。 如果该IP地址对应的节点已缓存该资源，节点将数据直接返回给用户，如图中步骤7和8，请求结束。 如果该IP地址对应的节点未缓存该资源，节点回源请求资源。获取资源后，结合用户自定义配置的缓存策略，将资源缓存至节点，如图中的北京节点，并返回给用户，请求结束。配置缓存策略的操作方法，请参见缓存配置。

责任共担 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的 云安全 挑战和无孔不入的云安全威胁与攻击，华为云在遵从法律法规业界标准的基础上，以安全生态圈为护城河，依托华为独有的软硬件优势，构建面向不同区域和行业的完善云服务安全保障体系。 安全性是华为云与您的共同责任，如图1所示。 华为云：负责云服务自身的安全，提供安全的云。华为云的安全责任在于保障其所提供的IaaS、PaaS和SaaS类云服务自身的安全，涵盖华为云数据中心的物理环境设施和运行其上的基础服务、平台服务、应用服务等。这不仅包括华为云基础设施和各项云服务技术的安全功能和性能本身，也包括运维运营安全，以及更广义的安全合规遵从。 租户：负责云服务内部的安全，安全地使用云。华为云租户的安全责任在于对使用的IaaS、PaaS和SaaS类云服务内部的安全以及对租户定制配置进行安全有效的管理，包括但不限于虚拟网络、 虚拟主机 和访客虚拟机的操作系统，虚拟防火墙、API网关和高级安全服务，各项云服务，租户数据，以及身份账号和密钥管理等方面的安全配置。 《华为云安全白皮书》详细介绍华为云安全性的构建思路与措施，包括云安全战略、责任共担模型、合规与隐私、安全组织与人员、基础设施安全、租户服务与租户安全、工程安全、运维运营安全、生态安全。 图1 华为云安全责任共担模型 父主题： 安全

相关操作 在使用HSS+CBR之外，建议按照如下方式从其他方面提升自身“免疫力”： 收敛互联网暴露面：定期扫描外部端口，保证公开范围最小化。 加强网络访问控制：各企业应具有明确的网络安全区域划分、访问限制规则，最小化开放访问权限，及时更新访问控制规则。 加强账号权限管控：通过身份管理、细粒度权限控制等访问控制规则为企业不同角色分配账号并授权，同时应提升特权账户的安全性。在另一方面，企业关键业务资产，需要妥善设置并保存账号及口令信息。关键资产上，配置双因素认证鉴别登录人员身份，可有效防范系统爆破风险。 搭建高可靠业务架构：采用集群模式的云服务部署模式。当某一个节点发生紧急问题，业务切换至备用节点，提升业务系统可靠性能力，也可防止数据丢失。在资源允许的条件下，企业或组织可以搭建同城或异地容灾备份系统，当主系统出现发生勒索事件后，可以快速切换到备份系统，从而保证业务的连续性。 制定安全事件应急预案：建立应对勒索病毒攻击等网络安全突发事件的应急组织体系和管理机制，明确工作原则、职责分工、应急流程、关键措施等。一旦发生勒索病毒攻击事件，立即启动内部网络安全应急预案，标准化开展应急处置工作来减轻、消除勒索病毒攻击影响。 加强企业员工安全意识：通过培训、演练等方式提高员工网络安全意识，明确国家网络安全法令及公司网络安全规范，能够识别网络钓鱼等常见的网络安全攻击，具备一定的事件处理能力，知晓安全事件带来的后果和影响。

解决方法 在管理PC上登录标准页面：https://192.168.0.1:8443/default.html。 在任意界面的右上角，单击“CLI控制台”。 图1 进入控制台 输入system-view，进入系统视图。 输入以下命令行配置认证方式。 配置后就可以使用密码password登录串口。 user-interface console 0 authentication-mode password set authentication password cipher password

故障处理原则 在遇到网络或业务异常时，请遵循以下原则对故障进行定界和恢复： 网络发生重大事故时，需依照快速定界故障、隔离故障的原则来尽快恢复业务。 定界故障：根据不同的故障现象匹配不同的故障定界思路流程，快速确定故障点。 快速恢复：通过隔离端口、隔离设备等手段，将故障目标暂时隔离，隔离的前提是网络有可靠性冗余备份，业务由其他正常节点承载，从而快速恢复业务。 在定位故障时，应及时获取并保存故障数据信息，不能随意删除数据。这些数据信息包括但不局限于网络拓扑、故障业务涉及的IP地址范围、故障接入点位置等。 在确定故障处理方案时，应先评估故障影响大小。 第三方硬件出现故障，可查看第三方相关资料或拨打第三方公司的服务电话求助。 维护人员在上岗前必须接受必要的应急维护培训，应熟练使用数据中心各个产品的运维功能，学习判断紧急事故的基本方法、掌握处理紧急事故的基本技能。 父主题： 维护工程师必读

硬件类危险操作 操作大类 操作小类 可能引发的后果 单板操作 严禁在线拔出主用主控板 当备用主控板工作正常时，由于主备主控板之间的数据同步需要一定的周期，在线拔出主用主控板后，系统虽然会自动进行倒换，但主用主控板上的最新数据不能完全自动备份到备用主控板上，导致系统统计出错或数据丢失。 当备用主控板工作不正常时，在线拔出主用主控板后，将导致相应模块的业务处理全部中断，使系统出现局部或全局业务阻塞 严禁随意按下主控板面板上的Reset按钮 当按下单板面板上的Reset按钮时，单板将被强行执行硬件复位，该操作仅能由有资质的维护人员在系统出现严重故障的情况下执行。 如果由于误操作按下主控板面板上的Reset按钮，将导致主控板复位，其后果与“在线拔出主用主控板”一样。 严禁随意按下OFL单板离线按钮 将使单板下电，业务中断。 严禁在不戴防静电腕带的情况下拔插单板 人体静电对单板上的电子器件具有很大的危害，维护人员在不戴防静电腕带的情况下拔插单板，很容易使单板遭受静电危害，从而损坏单板或使单板运行不稳定。 严禁使用串口线连接单板的调试串口进行调试 单板的调试串口仅能由集成商或华为公司的专业工程师使用。普通维护人员使用调试串口可能会导致单板程序运行异常、单板复位等后果。 CF卡操作 严禁对CF卡进行热插拔操作 在对CF卡进行读写操作的过程中（尤其是写操作），将CF卡拔出再插入，可能使操作系统异常，出现死循环复位，或使CF卡所在的主控板复位。 线缆类操作 严禁随意拔插机柜内部的网线 机柜内部的网线连接主要用于实现主机与维护终端之间的通信等功能，随意拔插网线将可能导致维护终端无法登录设备等。 电源类操作 严禁随意操作机柜配电框内的电源开关 只有在升级、扩容、更换部件或系统发生重大故障的情况下，维护人员才能按照操作规程操作各类电源开关，随意操作电源开关将导致设备停止运行、业务中断等重大事故。

命令类危险操作 功能分类 命令 命令功能 可能引发的后果 重启操作 reboot 重启系统 该命令仅在开局或升级时由专业工程师使用，否则将导致整个设备业务中断。 reset slot 重启单板 执行该命令，将重启指定的单板，相关业务中断。 关闭操作 power off slot 单板下电 执行该命令，将使指定单板下电，相关业务中断。 shutdown 关闭端口 执行该命令，对应的端口将不可用，相关的链路和业务中断。 删除操作 format 格式化存储设备 执行该命令进行格式化操作，将导致指定的存储设备上所有目录和文件丢失，并且不可恢复。 delete 删除设备存储设备中的指定文件 该命令用来删除存储设备中的指定文件，如果使用了参数unreserved，会彻底删除指定文件，删除的文件将不可恢复。 复位操作 reset 复位各类协议 请勿随意使用reset命令复位各类协议，否则会造成业务中断。 不要通过命令行在设备上修改华为乾坤云平台下发的配置，例如删除广播域BD、解除VNI与BD的绑定关系、修改VTEP的IP地址、修改VBDIF接口的IP地址等，否则可能会导致VXLAN业务不能正常运行。

联系技术支持 方式1：联系华为技术有限公司客户服务中心。 客户服务电话：400-822-9999（中国区服务热线）、全球售后服务热线（企业用户）、全球TAC覆盖信息（运营商用户） 客户服务邮箱：support_e@huawei.com（企业用户）、support@huawei.com（运营商用户） 方式2：创建工单。登录华为乾坤控制台，在个人帐号悬浮框处，单击“我的工单”，创建工单。 方式3：求助智能助手小坤。 方式4：访问华为企业业务技术支持网站或华为运营商技术支持网站，搜索故障案例或在技术论坛中发帖寻求帮助。

可能原因 设备默认开启硬件快转，对不需要安全检测的流量做快速转发（首包检测后未命中安全策略的流量）提升设备性能，减少CPU负担。开启硬件快转后，走硬件快转的流量不会统计在内，所以远小于客户下载流量，设备统计无误。 设备关闭硬件快转（会影响设备性能）关闭后设备上统计的流量大小远大于实时下载速度，因为统计纬度不一样。设备上的流量统计是到网络层的，浏览器下载是到应用层，设备统计流量会更大。设备统计无误。 源ip流量实时排名本身设备不开启，开启也会占用一部分设备性能，而且只要切换设备标签页就会自动关闭源ip流量统计，这个功能设备本身不提倡开启。

解决办法 DHCP配置有误，三层网关部署，如果设备自身要作为内网终端的DNS服务器，那么配置的时候必须选指定DNS，如果选系统的DNS设置，需要额外配置一条trust-local的安全策略做放行，否则内网终端获取到IP也无法上网。 注：使用系统的DNS设置，需要手动创建一条trust到local的安全策略并放通dns服务。 三层网关部署，设备本身给下联交换机做dhcp服务器，这种情况下联PC能不能通外网，要看一下自己本机是不是用的dhcp方式，如果是之前自己配置的静态ip，那肯定是不通外网的。确认一下当前测试PC的网段对不对。 内网终端获取不到IP的话要看下内网接口的配置，虚拟系统必须是public，不能是default. （默认public）。

实例操作限制 表5 实例操作限制 限制项 说明 存储引擎 支持InnoDB存储引擎。 实例部署 实例所部署的云服务器，对用户都不可见，即只允许应用程序通过IP地址/域名和端口访问数据库。 数据迁移 使用DRS可以快速解决多场景下，数据库之间的数据流通问题，操作便捷、简单，仅需分钟级就能搭建完成迁移任务。通过服务化迁移，免去了传统的DBA人力成本和硬件成本，帮助您降低数据传输的成本。 主备复制 Flexus云数据库RDS本身提供主备复制架构的双节点集群，无需用户手动搭建。其中主备复制架构集群的备实例不对用户开放，用户应用不可直接访问。 重启实例 无法通过命令行重启，必须通过Flexus云数据库RDS的管理控制台操作重启实例。 查看备份 下载手动和自动备份文件，用于本地存储备份。支持使用OBS Browser+下载、直接浏览器下载、按地址下载备份文件。 更多信息，请参见下载全量备份文件。 日志管理 默认开启日志，不支持关闭。 默认开启Binlog，无需额外配置。

安全限制 表4 安全限制 限制项 说明 管理员账户root权限 创建实例页面只提供管理员root账户，支持的权限请参见root账户权限。 说明： 建议用户谨慎对root账户执行revoke、drop user、rename user操作，避免影响业务正常使用。 管理员账户root的密码 长度为8~32个字符。 至少包含大写字母、小写字母、数字、特殊字符三种字符的组合，其中允许输入~ ! @ # $ % ^ * - _ = + ? , ( ) & . | 特殊字符。 更多信息，请参见重置管理员密码。 数据库端口 3306。 系统账户 创建Flexus云数据库RDS实例时，系统会自动为实例创建如下系统账户（用户不可使用），用于给数据库实例提供完善的后台运维管理服务。 rdsAdmin：管理账户，拥有最高权限，用于查询和修改实例信息、故障排查、迁移、恢复等操作。 rdsRepl：复制账户，用于备实例在主实例上同步数据。 rdsBackup：备份账户，用于后台的备份。 rdsMetric：指标监控账户，用于watchdog采集数据库状态数据。

root账户权限 表6 root账户权限 权限 权限级别 描述 是否支持 Select 表 查询权限 支持 Insert 表 插入权限 Update 表 更新权限 Delete 表 删除权限 Create 数据库、表或索引 创建数据库、表或索引权限 Drop 数据库或表 删除数据库或表权限 Reload 服务器管理 执行flush-hosts、flush-logs、flush-privileges、flush-status、flush-tables、flush-threads、refresh、reload等命令的权限。 Process 服务器管理 查看进程权限 Grant 数据库、表或保存的程序 赋予控制访问权限 References 数据库或表 操作外键权限 Index 表 索引权限 Alter 表 更改表，比如添加字段、索引等 Show_db 服务器管理 查看数据库链接 Create_tmp_table 服务器管理 创建临时表权限 Lock_tables 服务器管理 锁表权限 Execute 存储过程 执行存储过程权限 Repl_slave 服务器管理 复制权限 Repl_client 服务器管理 复制权限 Create_view 视图 创建视图权限 Show_view 视图 查看视图权限 Create_routine 存储过程 创建存储过程权限 Alter_routine 存储过程 更改存储过程权限 Create_user 服务器管理 创建用户权限 Event 数据库 事件触发器 Trigger 数据库 触发器 Super 服务器管理 执行kill线程权限 不支持 说明： 具体请参考root账号为什么没有super权限。 File 服务器上的文件访问 访问数据库服务器节点文件权限 不支持 Shutdown 服务器管理 关闭数据库权限 Create_tablespace 服务器管理 创建表空间权限

配额 表2 配额 资源类型 限制 说明 标签 1个实例最多支持20个标签配额。 更多信息，请参见标签。 免费备份空间 Flexus云数据库RDS提供了和实例磁盘大小相同的部分免费存储空间，用于存放您的备份数据。 免费的存储空间是在收取了数据盘的存储空间费用后赠送的，更多信息，请参见Flexus云数据库RDS的备份是如何收费的。 自动备份保留天数 默认7天，不支持修改。 备份文件保留7天可以满足绝大部分用户使用场景。如果需要保留超过7天，请创建手动备份。 日志保留天数 错误日志明细：30天 慢日志明细：7天 更多信息，请参见日志管理。

产品优势 创建使用 您可以通过华为云官网实时生成目标实例。推荐使用数据管理服务（Data Admin Service，简称DAS）这款可视化的专业数据库管理工具连接实例，可获得执行SQL、高级数据库管理、智能化运维等功能，做到易用、安全、智能地管理数据库。 稳定可靠 后台服务每天自动备份数据，备份都是以压缩包的形式自动存储在 对象存储服务 （Object Storage Service，简称OBS）。自动备份产生的备份文件保留7天，支持7天内一键式恢复。7天内的备份文件可以满足绝大部分用户使用场景。 支持按备份文件和指定时间点的恢复，可以将7天内任意一个时间点的数据恢复到FlexusRDS新实例或当前实例。 自动扩容 自动扩容状态默认关闭，用户可以购买实例后开启。开启后可以根据您的业务情况自动扩容存储空间，可以通过设置扩容上限和步长，使得磁盘使用量贴合业务增长，带来方便的同时帮助用户节省费用。 安全防护 FlexusRDS处于多层防火墙的保护之下，可以有力地抗击各种恶意攻击，保证数据安全，防御DDoS攻击、防SQL注入等。 极简运维 FlexusRDS提供专业数据库管理平台，重启、重置密码、参数修改、查看错误日志和慢日志、恢复数据等一键式功能。提供CPU利用率、IOPS、连接数、磁盘空间等实例信息实时监控及告警，让您随时随地了解实例动态。

常用概念 实例 FlexusRDS的最小管理单元是实例，一个实例代表了一个独立运行的数据库。用户可以在FlexusRDS中自助创建及管理实例。 数据库引擎 FlexusRDS支持MySQL引擎。 实例类型 FlexusRDS实例分为单机实例和主备实例。 表1 实例类型简介 实例类型 简介 使用说明 单机实例 采用单个数据库节点部署架构。与主备实例相比，它只包含一个节点，但具有高性价比。 单机版出现故障后，无法保障及时恢复。 主备实例 采用一主一备的经典高可用架构，支持跨AZ高可用。主实例和备实例共用一个IP地址。 备机提高了实例的可靠性，创建主机的过程中，会同步创建备机，备机创建成功后，用户不可见。 当主节点故障后，会发生主备切换，期间数据库客户端会发生短暂中断。如果存在复制延时，主备切换时间会长一点，数据库客户端需要支持重新连接。 实例规格 FlexusRDS实例的vCPU个数和内存、数据盘大小，以及实例类型按套餐进行购买，当前支持的规格套餐如下： 表2 规格套餐 规格 实例类型 经济版：2核4G SSD云盘120GB 单机 经济版：2核8G SSD云盘240GB 单机 经济版：4核8G SSD云盘240GB 单机 高可用：2核4G SSD云盘120GB 主备 高可用：2核8G SSD云盘240GB 主备 高可用：4核8G SSD云盘240GB 主备 自动备份 创建实例时，FlexusRDS默认开启自动备份策略，实例创建成功后，不支持修改备份策略。 手动备份 手动备份是由用户启动的数据库实例的全量备份，手动备份生成的备份文件用户可以自行下载，删除，用户还可以长期保存，直到用户退订实例。

FlexusRDS和RDS for MySQL的区别 表3 FlexusRDS与RDS for MySQL的区别 类别 FlexusRDS RDS for MySQL 规格 最小支持2U4GB，最大可支持4U8GB。 支持更多的高规格类型，详见RDS for MySQ L实例 规格。 扩展性 不支持只读实例。 支持存储自动扩容，最大支持4TB。 最多添加5个只读节点，添加只读所需时间与数据量大小相关，并且需要增加一份存储。 存储自动扩容，最大支持4TB。 备份恢复 通过全量备份+Binlog回放实现任意时间点回滚。 支持恢复到新实例和当前实例。 通过全量备份+Binlog回放实现任意时间点回滚。 支持恢复到新实例、当前实例和已有实例(非原实例)。 支持库表级任意时间点恢复。 数据库版本 MySQL 5.7和8.0。 MySQL 5.6、5.7和8.0。

请求示例 查询所有实例列表 GET https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/instances 根据指定条件查询实例列表 GET https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/instances?id=ed7cc6166ec24360a5ed5c5c9c2ed726in01&name=hy&type=Ha&datastore_type=MySQL&offset=0&limit=10&tags=rds001=001,rds002=002&group_type=flexus

URI URI格式 GET /v3/{project_id}/instances?id={id}&name={name}&type={type}&datastore_type={datastore_type}&group_type={group_type}&offset={offset}&limit={limit}&tags={key}={value} 参数说明 表1 参数说明 名称 参数类型 是否必选 说明 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 id String 否 参数解释： 实例ID。 “*”为系统保留字符，如果ID是以“*”起始，表示按照*后面的值模糊匹配，否则，按照ID精确匹配查询。不能只传入“*”。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 name String 否 参数解释： 实例名称。 “*”为系统保留字符，如果name是以“*”起始，表示按照*后面的值模糊匹配，否则，按照name精确匹配查询。不能只传入“*”。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 type String 否 参数解释： 按照实例类型查询。 约束限制： 不涉及。 取值范围： 取值Single、Ha，分别对应于单实例、主备实例。 默认取值： 不涉及。 datastore_type String 否 参数解释： 数据库类型。 约束限制： 不涉及。 取值范围： MySQL，区分大小写。 默认取值： 不涉及。 offset Integer 否 参数解释： 索引位置，偏移量。 约束限制： 不涉及。 取值范围： 从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。 默认取值： 0 limit Integer 否 参数解释： 查询记录数。 约束限制： 不涉及。 取值范围： 默认为100，不能为负数，最小值为1，最大值为100。 默认取值： 100 tags Array of objects 否 参数解释： 根据实例标签键值对进行查询。详情请参见表2。 约束限制： 如果同时使用多个标签键值对进行查询，中间使用逗号分隔开，最多包含20组。 group_type String 是 参数解释： 查询FlexusRDS实例列表。 约束限制： 不涉及。 取值范围： flexus 默认取值： 不涉及。 表2 tags字段数据结构说明 名称 参数类型 是否必选 说明 key String 是 参数解释： 标签键。 约束限制： 不涉及。 取值范围： 长度为1-128个unicode字符。 可以包含任何语种字母、数字、空格和_.:=+-@，但首尾不能含有空格，不能以_sys_开头。 默认取值： 不涉及。 value String 否 参数解释： 标签值。 约束限制： 不涉及。 取值范围： 最大长度255个unicode字符，可以为空字符串。 可以包含任何语种字母、数字、空格和_.:=+-@。 默认取值： 不涉及。

响应消息体（可选） 该部分可选。响应消息体通常以结构化格式（如JSON或XML）返回，与响应消息头中Content-Type对应，传递除响应消息头之外的内容。 对于获取用户Token接口，返回如下消息体。为篇幅起见，这里只展示部分内容。 { "token": { "expires_at": "2019-02-13T06:52:13.855000Z", "methods": [ "password" ], "catalog": [ { "endpoints": [ { "region_id": "az-01", ...... 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "error_code": "AS.0001", "error_msg": "The format of message is error" } 其中，“error_code”表示错误码，“error_msg”表示错误描述信息。

URI URI格式 GET /v3/{project_id}/backups?instance_id={instance_id}&backup_id={backup_id}&backup_type={backup_type}&offset={offset}&limit={limit}&begin_time={begin _time}&end_time={end_time} 参数说明 表1 参数说明 名称 是否必选 参数类型 说明 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 String 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 backup_id 否 String 参数解释： 备份ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 backup_type 否 String 参数解释： 备份类型。 约束限制： 不涉及。 取值范围： “auto”：自动全量备份。 “manual”：手动全量备份。 “fragment”：差异全量备份。 “incremental”：自动增量备份。 默认取值： 不涉及。 status 否 String 参数解释： 备份状态。 约束限制： 不涉及。 取值范围： “BUILDING”：备份中。 “COMPLETED”：备份完成。 “FAILED”：备份失败。 默认取值： 不涉及。 offset 否 Integer 参数解释： 索引位置，偏移量。 约束限制： 不涉及。 取值范围： 从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。 默认取值： 0 limit 否 Integer 参数解释： 查询记录数。 约束限制： 不涉及。 取值范围： 默认为100，不能为负数，最小值为1，最大值为100。 默认取值： 100 begin_time 否 String 参数解释： 查询开始时间。 约束限制： “begin_time”有值时，“end_time”必选。 取值范围： 格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 默认取值： 不涉及。 end_time 否 String 参数解释： 查询结束时间。 约束限制： “end_time”有值时，“begin_time”必选。 取值范围： 格式为“yyyy-mm-ddThh:mm:ssZ”，且大于查询开始时间。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 默认取值： 不涉及。

请求示例 GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/backups?instance_id=43e4feaab48f11e89039fa163ebaa7e4in01&backup_id=c0c9f155c7b7423a9d30f0175998b63bbr01&backup_type=auto&offset=0&limit=10&begin_time=2018-08-06T10:41:14+0800&end_time=2018-08-16T10:41:14+0800

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 backups Array of objects 参数解释： 备份列表。详情请参见表3。 total_count Integer 参数解释： 总记录数。 取值范围： 不涉及。 表3 backups字段数据结构说明 名称 参数类型 说明 id String 参数解释： 备份ID。 取值范围： 不涉及。 name String 参数解释： 备份名称。 取值范围： 不涉及。 type String 参数解释： 备份类型。 取值范围： “auto”：自动全量备份。 “manual”：手动全量备份。 “fragment”：差异全量备份。 “incremental”：自动增量备份。 size Long 参数解释： 备份大小，单位：KB。 取值范围： 不涉及。 status String 参数解释： 备份状态。 取值范围： BUILDING: 备份中。 COMPLETED: 备份完成。 FAILED：备份失败。 DELETING：备份删除中。 begin_time String 参数解释： 备份开始时间。 全量备份类型下，指备份开始时间。 MySQL增量备份类型，指备份文件中上一轮增备任务的最后一个事务的提交时间。 取值范围： 格式为“yyyy-mm-ddThh:mm:ssZ”。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 end_time String 参数解释： 备份结束时间。 全量备份类型下，指备份结束时间。 MySQL增量备份类型，指备份文件中最后一个事务的提交时间。 取值范围： 格式为“yyyy-mm-ddThh:mm:ssZ”，其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 datastore Object 参数解释： 数据库版本信息。详情请参见表4。 instance_id String 参数解释： 备份所在实例ID。 取值范围： 不涉及。 associated_with_ddm Boolean 参数解释： 是否已被DDM实例关联。 取值范围： 不涉及。 表4 datastore字段数据结构说明 名称 参数类型 说明 type String 参数解释： 数据库引擎。 取值范围： MySQL version String 参数解释： 数据库版本。 取值范围： 5.7、8.0 正常响应样例 { "backups": [{ "id": "43e4feaab48f11e89039fa163ebaa7e4br01", "name": "xxxx.xxx", "type": "auto", "size": 2803, "status": "COMPLETED", "begin_time": "2018-08-06T12:41:14+0800", "end_time": "2018-08-06T12:43:14+0800", "datastore": { "type": "MySQL", "version": "5.7" }, "instance_id": "a48e43ff268f4c0e879652d65e63d0fbin01", "associated_with_ddm": false }], "total_count": 1 } 异常响应 请参见异常请求结果。

响应消息 正常响应要素说明 表9 要素说明 名称 参数类型 说明 instance Object 参数解释： 实例信息。详情请参见表10。 job_id String 参数解释： 实例创建的任务ID。仅按需实例时返回该参数。 取值范围： 不涉及。 表10 instance说明 名称 参数类型 说明 id String 参数解释： 实例ID。 取值范围： 不涉及。 name String 参数解释： 实例名称。用于表示实例的名称，同一租户下，同类型的实例名称可相同。 取值范围： 与请求参数值相同。 status String 参数解释： 实例状态。 取值范围： BUILD，表示创建中。 datastore Object 参数解释： 数据库信息。详情请参见表11。 ha Object 参数解释： HA配置参数，仅当您选择创建HA实例时该参数才可见。 详情请参见表12。 port String 参数解释： 数据库端口信息。 取值范围： 与请求参数值相同。 backup_strategy Object 参数解释： 自动备份策略。详情请参见表13。 flavor_ref String 参数解释： 规格ID。使用可参考查询数据库规格响应消息表3中的“spec_code”。 volume Object 参数解释： volume信息。详情请参见表14。 region String 参数解释： 区域ID。 取值范围： 与请求参数值相同。 availability_zone String 参数解释： 可用区ID。 取值范围： 与请求参数值相同。 vpc_id String 参数解释： 虚拟私有云ID。 取值范围： vpc-default-smb subnet_id String 参数解释： 子网的网络ID信息。 取值范围： subnet-default-smb security_group_id String 参数解释： 指定实例所属的安全组。 取值范围： sg-default-smb charge_info Object 参数解释： 计费方式信息。详情请参见表7。 表11 datastore字段数据结构说明 名称 是否必选 参数类型 说明 type 是 String 参数解释： 数据库引擎。 取值范围： MySQL version 是 String 参数解释： 数据库版本。 取值范围： 5.7、8.0 表12 ha字段数据结构说明 名称 是否必选 参数类型 说明 mode 是 String 参数解释： 实例主备模式。 取值范围： HA，不区分大小写。 replication_mode 是 String 参数解释： 备机同步参数。 取值范围： async：异步模式。 semisync：半同步模式。 表13 backupStrategy字段数据结构说明 名称 是否必选 参数类型 说明 start_time 是 String 参数解释： 备份时间段。自动备份将在该时间段内触发。 取值范围： 非空，格式必须为hh:mm-HH:MM且有效，当前时间指UTC时间。 HH取值必须比hh大1。 mm和MM取值必须相同，且取值必须为00、15、30或45。 示例： 08:15-09:15 23:00-00:00 如果请求体中“backup_strategy”为空，则响应体中 “start_time”默认返回“02:00-03:00”。 keep_days 否 Integer 参数解释： 指定备份文件的可保存天数。 取值范围： 0～732。取值为0，表示关闭自动备份策略。如果需要延长保留时间请联系客服人员申请，自动备份最长可以保留2562天。 如果请求体中“backup_strategy”为空，则响应体中 “keep_days”默认返回“7”。 表14 volume字段数据结构说明 名称 是否必选 参数类型 说明 type 是 String 参数解释： 磁盘类型。 取值范围： CLOUDSSD：区分大小写，表示SSD云盘，仅支持通用型和独享型规格实例。 size 是 Integer 参数解释： 磁盘大小。 取值范围： 40 GB~4000 GB，必须为10的整数倍。 响应样例中参数“region”和“availability_zone”的值为示例值。 正常响应样例 恢复FlexusRDS备份文件到新实例 { "instance": { "id": "f5ffdd8b1c98434385eb001904209eacin01", "name": "demoname", "status": "BUILD", "datastore": { "type": "MySQL", "version": "5.7.31" }, "port": "3306", "volume": { "type": "ULTRAHIGH", "size": "40" }, "region": "aaa", "backup_strategy": { "start_time": "02:00-03:00", "keep_days": "7" }, "flavor_ref": "rds.mysql.s1.large", "availability_zone": "bbb", "vpc_id": "19e5d45d-70fd-4a91-87e9-b27e71c9891f", "subnet_id": "bd51fb45-2dcb-4296-8783-8623bfe89bb7", "security_group_id": "23fd0cd4-15dc-4d65-bdb3-8844cc291be0" }, "job_id": "bf003379-afea-4aa5-aa83-4543542070bc" } 异常响应 请参见异常请求结果。

请求示例 将FlexusRDS备份文件恢复到新实例。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances { "name": "targetInst", "availability_zone": "bbb,ccc", "ha": { "mode": "ha", "replication_mode": "async" }, "flavor_ref": "rds.mysql.y1.xlarge.2.ha", "volume": { "type": "CLOUDSSD", "size": 40 }, "region": "aaa", "backup_strategy": { "keep_days": 2, "start_time": "19:00-20:00" }, "password": "Demo@12345678", "time_zone": "UTC+04:00", "restore_point": { "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01", "type": "backup", "backup_id": "2f4ddb93-b901-4b08-93d8-1d2e472f30fe" } } 将FlexusRDS实例的数据恢复到指定时间点。 { "name": "targetInst", "availability_zone": "bbb,ccc", "ha": { "mode": "ha", "replication_mode": "async" }, "flavor_ref": "rds.mysql.y1.xlarge.2.ha", "volume": { "type": "CLOUDSSD", "size": 40 }, "backup_strategy": { "keep_days": 2, "start_time": "19:00-20:00" }, "password": "Demo@12345678", "time_zone": "UTC+04:00", "restore_point": { "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01", "type": "timestamp", "restore_time": 1532001446987 } }

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 name 是 String 参数解释： 实例名称。 约束限制： 同一租户下，同类型的实例名可重名。 取值范围： 实例名称长度最小为4字符，最大为64个字符，如果名称包含中文，则不超过64字节（注意：一个中文字符占用3个字节），必须以字母或中文开头，区分大小写，可以包含字母、数字、中划线、下划线、英文句号或中文，不能包含其他特殊字符。 默认取值： 不涉及。 password 否 String 参数解释： 数据库密码。 约束限制： 建议您输入高强度密码，以提高安全性，防止出现密码被暴力破解等安全风险。如果您提供的密码被系统视为弱密码，您将收到错误提示，请提供更高强度的密码。 取值范围： 数据库支持的密码长度是8~32个字符，至少包含大写字母、小写字母、数字、特殊字符三种字符的组合。允许输入~!@#$%^*-_=+?,()&特殊字符。 默认取值： 不涉及。 flavor_ref 是 String 参数解释： 规格码。 约束限制： 不涉及。 取值范围： 非空。参考查询数据库规格响应消息表3中的“spec_code”获取。 默认取值： 不涉及。 volume 是 Object 参数解释： 实例存储信息。详情请参见表5。 约束限制： 不涉及。 availability_zone 是 String 参数解释： 可用区ID。 约束限制： 对于数据库实例类型不是单机的实例，需要分别为实例所有节点指定可用区，并用逗号隔开。 取值范围： 非空，请参见地区和终端节点。 默认取值： 不涉及。 restore_point 是 Object 参数解释： 恢复数据源对象。详情请参见表6。 约束限制： 不涉及。 ha 否 Object 参数解释： HA配置参数，详情请参见表3。 约束限制： 仅创建主备实例时使用。 port 否 String 参数解释： 数据库端口信息。 约束限制： 不涉及。 取值范围： 不传该参数时，默认3306。 传入该参数时，取值1024～65535（其中12017和33071被RDS系统占用不可设置）。 默认取值： 3306 backup_strategy 否 Object 参数解释： 高级备份策略。详情请参见表4。 约束限制： 不涉及。 region 否 String 参数解释： 区域ID。 约束限制： 不涉及。 取值范围： 非空，请参见地区和终端节点。 默认取值： 不涉及。 charge_info 是 Object 参数解释： 包周期计费类型。详情请参见表7。 约束限制： 不涉及。 time_zone 否 String 参数解释： UTC时区。 约束限制： 不涉及。 取值范围： 不传该参数，默认为UTC时间。 传入该参数，取值范围为UTC-12:00~UTC+12:00，且只支持整段时间，如UTC+08:00，不支持UTC+08:30。 默认取值： UTC+08:00 tags 否 Array of objects 参数解释： 标签列表，根据标签键值对创建实例。 详情请参见表8。 约束限制： 如果创建实例时同时使用多个标签键值对，中间使用逗号分隔开，最多包含20组。 is_flexus 是 boolean 参数解释： 创建FlexusRDS实例。 约束限制： 不涉及。 取值范围： true 默认取值： 不涉及。 表3 ha字段数据结构说明 名称 是否必选 参数类型 说明 mode 是 String 参数解释： 实例主备模式。 约束限制： 不涉及。 取值范围： HA，不区分大小写。 默认取值： 不涉及。 replication_mode 是 String 参数解释： 备机同步参数。 约束限制： 不涉及。 取值范围： async：异步模式。 semisync：半同步模式。 默认取值： 不涉及。 表4 backup_strategy字段数据结构说明 名称 是否必选 参数类型 说明 start_time 是 String 参数解释： 备份时间段。自动备份将在该时间段内触发。 约束限制： 不涉及。 取值范围： 非空，格式必须为hh:mm-HH:MM且有效，当前时间指UTC时间。 HH取值必须比hh大1。 mm和MM取值必须相同，且取值必须为00、15、30或45。 示例： 08:15-09:15 23:00-00:00 默认取值： 不涉及。 keep_days 否 Integer 参数解释： 指定备份文件的可保存天数。 约束限制： 不涉及。 取值范围： 不传该参数，默认7天。 传入该参数，0～732。取值为0，表示关闭自动备份策略。如果需要延长保留时间请联系客服人员申请，自动备份最长可以保留2562天。 默认取值： 7 表5 volume字段数据结构说明 名称 是否必选 参数类型 说明 type 是 String 参数解释： 磁盘类型。 约束限制： 不涉及。 取值范围： CLOUDSSD：区分大小写，表示SSD云盘，仅支持通用型和独享型规格实例。 默认取值： 不涉及。 size 是 Integer 参数解释： 磁盘大小。 约束限制： 新实例磁盘大小必须大于或等于原实例的磁盘大小。 取值范围： 40 GB~4000 GB，必须为10的整数倍。 默认取值： 不涉及。 表6 restore_point字段数据结构说明 名称 是否必选 参数类型 说明 instance_id 是 String 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 type 是 String 参数解释： 恢复方式。 约束限制： 不涉及。 取值范围： “backup”，表示使用备份文件恢复，按照此方式恢复时，当“type”字段为非必选时，“backup_id”必选。 “timestamp”，表示按时间点恢复，按照此方式恢复时，当“type”字段必选时，“restore_time”必选。 默认取值： 不涉及。 backup_id 否 String 参数解释： 用于恢复的备份ID。当使用备份文件恢复时需要指定该参数。 约束限制： 当“type”字段为非必选时，“backup_id”必选。 取值范围： 不涉及。 默认取值： 不涉及。 restore_time 否 Integer 参数解释： 恢复数据的时间点，格式为UNIX时间戳，单位是毫秒，时区为UTC。 约束限制： 当“type”字段必选时，“restore_time”必选。 取值范围： 不涉及。 默认取值： 不涉及。 表7 charge_info字段数据结构说明 名称 是否必选 参数类型 说明 charge_mode 是 String 参数解释： 计费模式。 约束限制： 不涉及。 取值范围： prePaid：预付费，即包年/包月。 默认取值： 不涉及。 period_type 是 String 参数解释： 订购周期类型。 约束限制： 不涉及。 取值范围： month：包月。 year：包年。 默认取值： 不涉及。 period_num 否 Integer 参数解释： 订购时长。 约束限制： 不涉及。 取值范围： 当“period_type”为“month”时，取值为1~9。 当“period_type”为“year”时，取值为1~3。 默认取值： 不涉及。 is_auto_renew 否 boolean 参数解释： 包周期实例是否自动续订，续订的周期和原周期相同，且续订时会自动支付。 约束限制： 不涉及。 取值范围： true，为自动续订。 false，为不自动续订，默认该方式。 默认取值： false is_auto_pay 否 boolean 参数解释： 是否自动从客户的账户中支付，此字段不影响自动续订的支付方式。 约束限制： 不涉及。 取值范围： true，为自动支付。 false，为手动支付，默认该方式。 默认取值： false 表8 tags字段数据结构说明 名称 是否必选 参数类型 说明 key 是 String 参数解释： 标签键。 约束限制： 不涉及。 取值范围： 长度为1-128个unicode字符。 可以包含任何语种字母、数字、空格和_.:=+-@，但首尾不能含有空格，不能以_sys_开头。 默认取值： 不涉及。 value 是 String 参数解释： 标签值。 约束限制： 不涉及。 取值范围： 最大长度255个unicode字符，可以为空字符串。 可以包含任何语种字母、数字、空格和_.:=+-@。 默认取值： 不涉及。