华为云用户手册

操作流程 操作步骤 说明 准备工作 注册华为账号 并开通华为云、实名认证，为账户充值，购买E CS 。 开通CodeArts体验版 CodeArts支持包年/包月计费，使用CodeArts前需要完成购买，开通体验版即可完成本文中的操作流程。 新建项目 项目是使用CodeArts各服务的基础，创建项目后才能完成后续操作。 新建代码仓库 代码仓库用于项目代码的版本管理，本文使用服务内置的模板“Java Web Demo”创建代码仓库。 检查代码 通过代码检查服务，可以对代码进行静态检查，管控代码质量。 构建并归档软件包 通过编译构建服务，可将软件的源代码编译成目标文件，并把配置文件和资源文件等打包并归档到软件发布库中。 部署构建包 通过部署服务，可将软件发布库中的软件包部署到虚拟机，并启动运行。 配置流水线 通过流水线可以将代码检查、编译构建、部署等任务串联起来，当代码发生改变时，自动触发流水线执行，实现持续交付。 释放资源 按需计费的资源会产生持续计费，为了避免不必要的费用产生，完成体验后，可以释放不再使用的资源。

准备Dockerfile 单击仓库名称，进入代码仓库。 单击文件列表上方“新建”，在下拉列表中选择“新建文件”。 图1 新建文件 输入文件名Dockerfile，文件详情输入以下代码行。 FROM openjdk:8-alpine ADD target /demo COPY ./target/demoapp.jar /demo CMD ["java","-jar","/demo/demoapp.jar"] 输入备注信息，单击“提交”。

操作流程 操作步骤 说明 准备工作 注册华为账号并开通华为云、实名认证，为账户充值，购买CCE，创建SWR组织。 开通CodeArts体验版 CodeArts支持包年/包月计费，使用CodeArts前需要完成购买，开通体验版即可完成本文中的操作流程。 新建项目 项目是使用CodeArts各服务的基础，创建项目后才能完成后续操作。 新建代码仓库 代码仓库用于项目代码的版本管理，本文使用服务内置的模板“Java Web Demo”创建代码仓库。 准备Dockerfile Dockerfile是用于构建镜像的文本文件，其中包含了构建镜像所需的指令和说明。了解Dockerfile更详细说明，请参见Docker官网。 构建并推送镜像 通过编译构建任务将软件的源代码编译成镜像，并把镜像推送归档到SWR中。 创建负载 在CCE中创建无状态负载（Deployment），用于加载运行demo镜像。 部署镜像 通过在部署服务中创建应用，将镜像部署自动化。 配置流水线 通过配置流水线，将代码仓库、构建、部署串联起来，当代码仓库中发生代码提交动作时，可以自动触发流水线的执行，实现持续交付。 释放资源 按需计费的资源会产生持续计费，为了避免不必要的费用产生，完成体验后，可以释放部分不再使用的资源。

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 tags Array of objects 参数解释： 标签列表，没有标签默认为空数组。 详情请参见表3。 表3 tags字段数据结构说明 名称 参数类型 说明 key String 参数解释： 标签键。 取值范围： 不涉及。 value String 参数解释： 标签值。 取值范围： 不涉及。 tag_type String 参数解释： 标签类型。 取值范围： 枚举类型：user、system 正常响应样例 { "tags": [{ "key": "keyName", "value": "keyValue", "tag_type": "user" }] } 异常响应 请参见异常请求结果。

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

接口约束 如果您需要使用该功能，请联系客服提交开启修改数据库用户备注权限的申请。 实例在创建、变更规格、修改端口、异常或冻结状态下不能执行该操作。 更新备注的操作不受数据库是否存在影响。 若备注存在则更新，不存在则自动新建备注。 更新为空值备注将会被删除。 若新建备注过程中数据库被删除或不存在，则备注依旧会保存。 该方法只针对新版本的实例生效，必须大于等于指定的内核版本，如果不符合内核小版本要求，参考升级内核小版本升级至最新。 RDS for MySQL 5.6：不支持。 RDS for MySQL 5.7：不支持。 RDS for MySQL 8.0：大于等于8.0.25。 除RDS界面和API以外的其他方式创建的数据库和账号，如果创建的数据库名和账号名不满足数据库命名规则（参见表2）和账号命名规则（参见表2），例如包含中文或不支持的特殊字符，那么该数据库和账号不支持RDS界面或API的数据库管理和账号管理功能。 如果源库的数据库名和账号名不满足数据库命名规则（参见表2）和账号命名规则（参见表2），迁移到目标库RDS for MySQL后，该数据库和账号也不支持RDS界面或API的数据库管理和账号管理功能。

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 backup_policy 是 Object 备份策略对象，包括备份保留的天数和备份开始时间。 详情请参见表3。 reserve_backups 否 Boolean 仅关闭备份策略时有效，默认为true。 true：表示保留自动备份和差异备份。 false：表示关闭备份策略的同时，删除已有的自动备份和差异备份。 表3 backup_policy字段数据结构说明 名称 是否必选 参数类型 说明 keep_days 是 Integer 指定已生成的备份文件可以保存的天数。 取值范围：0～732。取0值，表示关闭自动备份策略。如果需要延长保留时间请联系客服人员申请，自动备份最长可以保留2562天。 须知： 关闭备份策略后，备份任务将立即停止，所有增量备份任务将立即删除，使用增量备份的相关操作可能失败，相关操作不限于下载、复制、恢复、重建等，请谨慎操作。 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 period 否 String 备份周期配置。自动备份将在每星期指定的天进行。除关闭自动备份策略外，必选。 取值范围：格式为逗号隔开的数字，数字代表星期。 取值示例：1,2,3,4则表示备份周期配置为星期一、星期二、星期三和星期四。

请求示例 设置周一和周二19:00~20:00内进行自动备份，备份文件保留7天。 PUT https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/backups/policy { "backup_policy": { "keep_days": 7, "start_time": "19:00-20:00", "period": "1,2" } } 关闭自动备份策略。 { "backup_policy": { "keep_days": 0 }, "reserve_backups": false }

响应消息 正常响应要素说明 表12 要素说明 名称 参数类型 说明 instance Object 实例信息。 详情请参见表13。 job_id String 实例创建的任务id。仅按需实例时返回该参数。 order_id String 订单号，仅RDS for SQL Server创建包年包月时返回该参数。 表13 instance说明 名称 参数类型 说明 id String 实例ID。 name String 实例名称。 用于表示实例的名称，同一租户下，同类型的实例名可重名，其中，RDS for SQL Server实例名唯一。 status String 实例状态。如BUILD，表示创建中。 datastore Object 数据库信息。 详情请参见表14。 ha Object HA配置参数，仅当您选择创建HA实例时该参数才可见。 详情请参见表15。 configuration_id String 参数模板id，仅当您创建实例指定用户自定义参数组时才可见。 port String 数据库端口信息。 RDS for MySQL数据库端口设置范围为1024～65535（其中12017和33071被RDS系统占用不可设置）。 RDS for PostgreSQL数据库端口修改范围为2100～9500。 对于RDS for SQL Server 2022 EE、2022 SE、2022 Web版、2019 EE、2019 SE、2019 Web版、2017 EE、2017 SE、2017 Web版：端口设置范围为1433和2100~9500（其中5050、5353、5355、5985和5986不可设置）。 除此之外的其他版本：端口设置范围为1433和2100~9500（其中5355、5985和5986不可设置）。 当不传该参数时，默认端口如下： RDS for MySQL默认3306。 RDS for PostgreSQL默认5432。 RDS for SQL Server默认1433。 backup_strategy Object 自动备份策略。 详情请参见表16。 enterprise_project_tag String 项目标签。 flavor_ref String 规格ID。 使用可参考查询数据库规格响应消息表3中的“spec_code”。 volume Object volume信息。 详情请参见表17。 region String 区域ID。 availability_zone String 可用区ID。 vpc_id String 虚拟私有云ID，获取方法如下： 方法1：登录虚拟私有云服务的控制台界面，在虚拟私有云的详情页面查找VPC ID。 方法2：通过虚拟私有云服务的API接口查询，具体操作可参考查询VPC列表。 subnet_id String 子网的网络ID信息，获取方法如下： 方法1：登录虚拟私有云服务的控制台界面，单击VPC下的子网，进入子网详情页面，查找网络ID。 方法2：通过虚拟私有云服务的API接口查询，具体操作可参考查询子网列表。 security_group_id String 指定实例所属的安全组。 方法1：登录虚拟私有云服务的控制台界面，在安全组的详情页面查找安全组ID。 方法2：通过虚拟私有云服务的API接口查询，具体操作可参考查询安全组列表。 collation String RDS for SQL Server设定的字符集信息。 charge_info Object 计费方式信息，支持包年/包月和按需。 详情请参见表10。 表14 datastore字段数据结构说明 名称 是否必选 参数类型 说明 type 是 String 数据库引擎。支持的引擎如下，不区分大小写： MySQL PostgreSQL SQLServer version 是 String 数据库版本。 数据库支持的详细版本信息，可调用查询数据库引擎的版本接口获取。 complete_version 否 String 数据库完整版本号。仅在数据库引擎是”PostgreSQL”时返回。 表15 ha字段数据结构说明 名称 是否必选 参数类型 说明 mode 是 String 实例主备模式，取值：Ha。 replication_mode 是 String 备机同步参数。 取值：非空。 MySQL为“async”或“semisync”。 PostgreSQL为“async”或“sync”。 Microsoft SQL Server为“sync”。 说明： “async”为异步模式。 “semisync”为半同步模式。 “sync”为同步模式。 表16 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 keep_days 否 Integer 指定已生成备份文件的可保存天数。 取值范围：0～732。该参数缺省，或取0值，表示关闭自动备份策略。如果需要延长保留时间请联系客服人员申请，自动备份最长可以保留2562天。 表17 volume字段数据结构说明 名称 是否必选 参数类型 说明 type 是 String 磁盘类型。 取值范围如下，区分大小写： ULTRAHIGH，表示超高IO型磁盘。 LOCALSSD，表示本地SSD盘。 CLOUDSSD，表示SSD云盘。 ESSD，表示极速型SSD。 size 是 Integer 磁盘大小。 取值范围：40GB~4000GB。必须为10的整数倍。 正常响应样例 MySQL { "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" } PostgreSQL { "instance": { "id": "f5ffdd8b1c98434385eb001904209eacin01", "name": "demoname", "status": "BUILD", "datastore": { "type": "PostgreSQL", "version": "9.6.13" }, "port": "5432", "volume": { "type": "ULTRAHIGH", "size": "40" }, "region": "aaa", "backup_strategy": { "start_time": "02:00-03:00", "keep_days": "7" }, "flavor_ref": "rds.pg.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" } SQL Server { "instance": { "id": "f5ffdd8b1c98434385eb001904209eacin01", "name": "demoname", "status": "BUILD", "datastore": { "type": "sqlserver", "version": "2014_SE" }, "port": "2100", "volume": { "type": "ULTRAHIGH", "size": "40" }, "region": "aaa", "backup_strategy": { "start_time": "02:00-03:00", "keep_days": "7" }, "flavor_ref": "rds.mssql.2014.se.s3.large.2", "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", "charge_info": { "charge_mode": "prePaid", "period_num": 1 }, "collation": "Cyrillic_General_CI_AS" }, "order_id": "CS20122919584LQ7K" } Serverless型MySQL { "instance": { "id": "dbb35f31f4144086bf522ff8a124530din01", "name": "serverless", "status": "BUILD", "datastore": { "type": "MySQL", "version": "5.7.41" }, "ha": { "mode": "Ha", "replication_mode": "semisync" }, "port": "3307", "volume": { "type": "CLOUDSSD", "size": 100 }, "region": "aaa", "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "flavor_ref": "rds.mysql.serverless.ha", "availability_zone": "bbb,ccc", "vpc_id": "bd3e4c67-74da-459d-820f-9fecd4ea9ca4", "subnet_id": "53cdf568-6f56-4944-a996-4afcaffe994e", "security_group_id": "89f258c5-4b81-4ef0-be30-34f2ee07dd1c" }, "job_id": "908c05f7-958a-4411-b590-890eed175345" } 异常响应 请参见异常请求结果。

请求示例 将备份文件恢复到新实例。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances { "name": "targetInst", "availability_zone": "bbb,ccc", "ha": { "mode": "ha", "replication_mode": "async" }, "flavor_ref": "rds.mysql.s1.large", "volume": { "type": "ULTRAHIGH", "size": 40 }, "region": "aaa", "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.147", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "backup_strategy": { "keep_days": 2, "start_time": "19:00-20:00" }, "password": "Demo@12345678", "configuration_id": "52e86e87445847a79bf807ceda213165pr01", "enterprise_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c", "time_zone": "UTC+04:00", "restore_point": { "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01", "type": "backup", "backup_id": "2f4ddb93-b901-4b08-93d8-1d2e472f30fe" } } 将SQL Server备份文件中的部分数据库恢复到新实例。 { "name": "targetInst", "datastore": { "type": "SQLServer", "version": "2014_SE" }, "availability_zone": "bbb,ccc", "ha": { "mode": "ha", "replication_mode": "sync" }, "flavor_ref": "rds.mssql.2014.se.s3.xlarge.2.ha", "volume": { "type": "ULTRAHIGH", "size": 40 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.147", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "backup_strategy": { "keep_days": 2, "start_time": "19:00-20:00" }, "charge_info": { "charge_mode": "prePaid", "period_type": "month", "period_num": 1, "is_auto_renew": false, "is_auto_pay": true }, "password": "Demo@12345678", "configuration_id": "52e86e87445847a79bf807ceda213165pr04", "enterprise_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c", "time_zone": "UTC+04:00", "collation": "Cyrillic_General_CI_AS", "restore_point": { "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin04", "type": "backup", "backup_id": "2f4ddb93-b901-4b08-93d8-1d2e472f30fe", "database_name": { "db1": "dbtest1,dbtest2", "db2": "db2,db002", "db3": "" } } } 将实例的数据恢复到指定时间点。 { "name": "targetInst", "availability_zone": "bbb,ccc", "ha": { "mode": "ha", "replication_mode": "async" }, "flavor_ref": "rds.mysql.s1.large", "volume": { "type": "ULTRAHIGH", "size": 40 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "data_vip": "192.168.0.147", "backup_strategy": { "keep_days": 2, "start_time": "19:00-20:00" }, "password": "Demo@12345678", "configuration_id": "52e86e87445847a79bf807ceda213165pr01", "enterprise_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c", "time_zone": "UTC+04:00", "restore_point": { "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01", "type": "timestamp", "restore_time": 1532001446987 } } 将SQL Server实例的部分数据库恢复到指定时间点。 { "name": "targetInst", "datastore": { "type": "SQLServer", "version": "2014_SE" }, "availability_zone": "bbb,ccc", "ha": { "mode": "ha", "replication_mode": "sync" }, "flavor_ref": "rds.mssql.2014.se.s3.xlarge.2.ha", "volume": { "type": "ULTRAHIGH", "size": 40 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.147", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "backup_strategy": { "keep_days": 2, "start_time": "19:00-20:00" }, "charge_info": { "charge_mode": "prePaid", "period_type": "month", "period_num": 1, "is_auto_renew": false, "is_auto_pay": true }, "password": "Demo@12345678", "configuration_id": "52e86e87445847a79bf807ceda213165pr04", "enterprise_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c", "time_zone": "UTC+04:00", "collation": "Cyrillic_General_CI_AS", "restore_point": { "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin04", "type": "timestamp", "restore_time": 1532001446987, "database_name": { "db1": "dbtest1,dbtest2", "db2": "db2,db02", "db3": "" } } } 将Serverless型 MySQL备份 文件恢复到新实例。 { "name": "serverless", "datastore": { "type": "MySQL", "version": "5.7" }, "ha": { "mode": "ha", "replication_mode": "semisync" }, "flavor_ref": "rds.mysql.serverless.ha", "volume": { "type": "CLOUDSSD", "size": 100 }, "region": "aaa", "availability_zone": "bbb,ccc", "vpc_id": "bd3e4c67-74da-459d-820f-9fecd4ea9ca4", "subnet_id": "53cdf568-6f56-4944-a996-4afcaffe994e", "security_group_id": "89f258c5-4b81-4ef0-be30-34f2ee07dd1c", "port": 3307, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "password": "****", "time_zone": "UTC+08:00", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ], "dry_run": false, "serverless_info": { "min_cap": "0.5", "max_cap": "1" }, "restore_point": { "instance_id": "aceb1e359a444660bb8fe0696afc76e1in01", "type": "backup", "backup_id": "0db0b4b93e5d40afbd65ede29153dc46br01" } }

接口约束 源实例和目标实例的数据库类型必须一致，如都是MySQL。 原实例和目标实例的数据库版本约束如下： RDS for MySQL和RDS for PostgreSQL的原实例和目标实例的数据库版本必须一致。 RDS for SQL Server的原实例及目标实例的时区配置要完全一致，否则会有数据不一致风险。 RDS for SQL Server的原实例和目标实例的数据库版本约束参见表5。 RDS for MySQL和RDS for PostgreSQL数据库目标实例需大于或等于原实例的数据盘总大小。

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

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

请求消息 请求参数 名称 参数类型 是否必选 说明 target_version String 是 目标版本。 高于实例当前的大版本，如当前为12，目标版本需要是13或14。 is_change_private_ip Boolean 是 是否将实例内网IP切换到目标大版本实例。 true：升级后切换当前实例的内网IP到目标大版本实例。 false：升级后当前实例的内网IP不变，目标大版本实例使用新的内网IP。 statistics_collection_mode String 否 统计信息收集方式。“is_change_private_ip”为“true”时必选。 before_change_private_ip：将实例内网IP切换到目标大版本实例前收集。 after_change_private_ip：将实例内网IP切换到目标大版本实例后收集。 请求参数样例 { "target_version": "14.6.1", "is_change_private_ip": true, "statistics_collection_mode": "before_change_private_ip" }

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 restore_time Array of objects 可恢复时间段列表。 详情请参见表3。 表3 restore_time字段数据结构说明 名称 参数类型 说明 start_time Integer 可恢复时间段的起始时间点，UNIX时间戳格式，单位是毫秒，时区是UTC。 end_time Integer 可恢复时间段的结束时间点，UNIX时间戳格式，单位是毫秒，时区是UTC。 正常响应样例 { "restore_time": [ { "start_time": 1532001446987, "end_time": 1532742139000 } ] } 异常响应 请参见异常请求结果。

请求消息 请求参数 无。 URI样例 查询实例的所有可恢复时间段 GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/restore-time 根据指定日期查询实例的可恢复时间段 GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/restore-time?date=2020-12-26

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/restore-time?date=2020-12-26 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 instance_id 是 实例ID。 date 否 所需查询的日期，为yyyy-mm-dd字符串格式，时区为UTC。

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 db_name 是 String 数据库名称。 users 是 Array of objects 每个元素是与数据库相关联的账号。单次请求最多支持50个元素。 每个元素结构请参见表3。 表3 users列表元素数据结构说明 名称 是否必选 参数类型 说明 name 是 String 数据库账号名称。 数据库账号名称在1到32个字符之间，由字母、数字、中划线或下划线组成，不能包含其他特殊字符。 若数据库版本为RDS for MySQL 5.6，账号长度为1～16个字符。 若数据库版本为RDS for MySQL 5.7和8.0，账号长度为1～32个字符。

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

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

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 instance_id String 实例ID。 dns_name String 实例 域名 。 dns_type String 实例域名类型：private ipv6_address String 实例域名绑定的vIP。 status String 域名状态。 正常响应样例 { "instance_id": "2de6315e7197418fbf2fdaed59d65da1in03", "dns_name": "2de6315e7197418fbf2fdaed59d65da1in03.ipv6.internal.***.mysql.rds-dev.myhuaweicloud.com", "dns_type": "private", "ipv6_address": "2001:db8:a583:3:2312:c71d:6e71:c952", "status": "normal" } 异常响应 请参见异常请求结果。

响应消息 正常响应要素说明 表3 要素说明 名称 参数类型 说明 list List 扩展日志下载链接列表，详见表4。 count Integer 扩展日志链接数量。 表4 linkInfo字段数据结构说明 名称 参数类型 说明 file_name String 生成的下载文件名。 status String 链接的生成状态。 FINISH，表示下载链接已经生成。 EXPORTING，表示正在生成文件。 FAILED，表示存在日志文件准备失败。 file_size String 文件大小，单位：KB。 file_link String 下载链接，链接的生成状态为EXPORTING，或者FAILED时不予返回。 create_at String 生成时间。 update_at String 更新时间。 正常响应样例 正在生成扩展日志下载链接 { "list": [ { "file_name": "HkEngineEventFile_0_133337769850300000.xel", "status": "EXPORTING", "file_size": "0", "create_at": "2023-08-14T03:35:24+0000", "update_at": "2023-08-14T03:35:24+0000" } ], "count": 1 } 扩展日志下载链接获取成功 { "list": [ { "file_name": "HkEngineEventFile_0_133337769850300000.xel", "status": "SUC CES S", "file_size": "0", "file_link": "https://obs.xxx:443/xxx-7a95af72c4d54a31ae0663263f0e35ea/6e22b18b43a74e4486264194f6e09f66_EL_HkEngineEventFile_0_133337769850300000.xel?xxx", "create_at": "2023-08-14T03:35:41+0000", "update_at": "2023-08-14T03:35:41+0000" } ], "count": 1 } 异常响应 请参见异常请求结果。

请求示例 变更MySQL、PostgreSQL按需单机实例为主备实例。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action { "single_to_ha": { "az_code_new_node": "az2xahz" } } 变更MySQL、PostgreSQL包周期单机实例为主备实例。 { "single_to_ha": { "az_code_new_node": "az1xahz", "is_auto_pay": true } } 变更SQL Server按需单机实例为主备实例。 { "single_to_ha": { "az_code_new_node": "az2xahz", "ad_domain_info": { "dns_server_ip": "192.168.0.1", "domain_admin_account_name": "Administrator", "domain_admin_pwd": "password@123", "dc_domain_name": "test.com" } } } 变更SQL Server包周期单机实例为主备实例。 { "single_to_ha": { "az_code_new_node": "az2xahz", "is_auto_pay": true, "ad_domain_info": { "dns_server_ip": "192.168.0.1", "domain_admin_account_name": "Administrator", "domain_admin_pwd": "password@123", "dc_domain_name": "test.com" } } } 变更DeC用户单机实例为主备实例。 { "single_to_ha": { "az_code_new_node": "az2xahz", "password": "Test@1234567", "dsspool_id":"23728728428374823748327482r" } }

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 single_to_ha 是 Object 详情请参见表3。 表3 single_to_ha字段数据结构说明 名称 是否必选 参数类型 说明 az_code_new_node 是 String 实例节点可用区码（AZ）。 dsspool_id 否 String Dec用户专属存储ID，每个az配置的专属存储不同，实例节点所在专属存储ID，仅支持DEC用户创建时使用。 is_auto_pay 否 Boolean 仅包周期实例进行单机转主备时可指定，表示是否自动从客户的账户中支付。 true，为自动支付。 false，为手动支付，默认该方式。 ad_domain_info 否 Object 域信息，加域实例单机转主备时必填，非加域实例不需要填写。 仅RDS for SQL Server支持。 详细字段结构请参见表4。 表4 ADDomainInfo字段数据结构说明 参数 是否必选 参数类型 描述 domain_admin_account_name 是 String 域管理员账号名。 domain_admin_pwd 是 String 域管理员密码。

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。 用户 由账号在 IAM 中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域 指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。 可用区 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1 项目隔离模型 企业项目 企业项目是项目的升级版，针对企业不同项目间资源的分组和管理，是逻辑隔离。企业项目中可以包含多个区域的资源，且项目中的资源可以迁入迁出。 关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理服务用户指南》。 父主题： 使用前必读

请求示例 获取慢日志文件“Database_slowlog_name”的下载链接。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/slowlog-download { "file_name":"Database_slowlog_name" }

响应消息 正常响应要素说明 表3 要素说明 名称 参数类型 说明 list List 参数解释： 慢日志下载链接列表，详见表4。 status String 参数解释： 慢日志下载链接生成状态。 取值范围： FINISH，表示下载链接已经生成完成。 CREATING，表示正在生成文件，准备下载链接。 FAILED，表示存在日志文件准备失败。 count Integer 参数解释： 慢日志链接数量。 取值范围： 不涉及。 表4 linkInfo字段数据结构说明 名称 参数类型 说明 workflow_id String 参数解释： 任务ID。 取值范围： MySQL引擎该字段值固定为""。 file_name String 参数解释： 生成的下载文件名。 取值范围： 不涉及。 status String 参数解释： 当前链接的生成状态。 取值范围： EXPORTING，下载链接正在生成中。 SUCCESS，下载链接生成成功。 FAILED，下载链接生成失败。 file_size String 参数解释： 文件大小。单位：KB。 取值范围： 不涉及。 file_link String 参数解释： 下载链接。链接有效时间为5分钟。 取值范围： 不涉及。 create_at Long 参数解释： 生成时间。 取值范围： 不涉及。 update_at Long 参数解释： 更新时间。 取值范围： 不涉及。 正常响应样例 { "list": [ { "workflow_id": "44fb1d85-2fcc-4d63-ad3b-c3d1ecd7000e", "file_name": "054bc9c1f680d55c1f36c006e5a9f67b_slowlog_download_20200515080614589", "status": "SUCCESS", "file_size": "0", "file_link": "https://rdsbucket.xxxr.obs.cn-xianhz-1.myhuaweicloud.com:443/054bc9c1f680d55c1f36c006e5a9f67b_slowlog_download_20200515080614589?AWSAccessKeyId=1BQ38TBCQHAVQXBUMUTC&Expires=1589530200&response-cache-control=no-cache%2Cno-store&Signature=Fgi4%2BLOJ9frAXyOkz5hRoW5O%2BUM%3D", "create_at": 1589529991385, "update_at": 1589529991385 } ], "status": "finish", "count": 1 } 异常响应 请参见异常请求结果。

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

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

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 public_ip 否 String 须知： “is_bind”为“true”时，“public_ip”为必选。 待绑定的弹性公网IP地址，仅允许使用标准的IP地址格式。 public_ip_id 否 String 须知： “is_bind”为“true”时，“public_ip_id”为必选。 弹性公网IP对应的ID，仅允许使用标准的UUID格式。 is_bind 是 Boolean true：绑定弹性公网IP。 false：解绑弹性公网IP。