华为云用户手册

操作场景 云服务器备份存储库和SFS Turbo备份存储库支持将源存储库的所有备份复制到同一账号下另一区域的复制存储库中。云服务器备份后续可在另一个区域使用复制的备份数据创建镜像，并发放新的云服务器。SFS Turbo备份后续可在另一个区域使用复制的备份创建新的文件系统。通过复制功能，您可以快速跨区域部署业务。 复制存储库主要有以下两种复制方式： 选中某一个备份存储库，手动执行一次复制。 配置存储库的复制策略，周期性的对未向目标区域进行过复制或复制失败的备份执行复制操作。

约束与限制 云硬盘备份存储库不支持复制至其他区域。 支持复制到多个目标区域的存储库中，复制成功后会占用相应的存储容量。 存储库中包含同时满足以下条件的云服务器备份才能执行创建复制操作： 备份由弹性云服务器产生。 备份数据包含系统盘。 备份状态为“可用”。 存储库中包含同时满足以下条件的SFS Turbo备份才能执行创建复制操作： 备份由sfs turbo文件系统产生。 备份状态为“可用”。 仅支持对源区域生成的同类型备份存储库执行复制操作，不支持对复制操作产生的复制存储库再次执行复制操作，从其他区域复制而来的备份仅可用于创建镜像或文件系统。 一个备份存储库可以分别复制到不同的目标区域。对备份存储库手动创建复制或通过策略复制，每个目标区域仅能复制一次，即使将目标备份删除后也不允许再次复制。 仅支持复制到同备份类型的复制存储库中。例如，需要将云服务器在区域一产生的备份复制至区域二，则需要在区域二购买保护类型为“复制（跨区域）”的云服务器存储库。 仅支持向具备复制能力的目标区域复制备份存储库，具体支持复制到的目标区域对应情况详见表1。 表1 跨区域复制支持区域 源区域 支持复制到的目标区域 说明 乌兰察布一 北京四、上海一、广州 - 深圳 北京四 - 贵阳一 北京四、上海一 - 北京一 北京四、上海二、上海一、广州 - 北京四 乌兰察布一、深圳、贵阳一、北京一、上海二、上海一、广州 - 上海二 北京一、北京四、上海一、广州 - 上海一 乌兰察布一、贵阳一、北京一、北京四、上海二、广州 - 广州 乌兰察布一、北京一、北京四、上海二、上海一 - 香港、曼谷、新加坡 香港、曼谷、新加坡 几个区域间支持互相复制

约束与限制 如果系统盘在备份完成后，服务器切换过系统，则由于磁盘的UUID变化等原因将会导致系统盘备份无法恢复原系统盘。您可以使用系统盘备份创建新磁盘后，将数据导入原系统盘中。 目前仅支持将备份恢复至原磁盘中，暂不支持将备份恢复至其他磁盘中（仅华南-广州区域支持）。如果希望将备份恢复至其他的磁盘中，可以使用备份创建新的磁盘。 如果希望将数据盘恢复至系统盘上，请参考如何将数据盘备份恢复至系统盘？ 暂不支持批量恢复数据操作。

云备份支持的存储库功能 存储库支持如下操作。 表1 云备份支持的存储库功能 功能 说明 查看存储库 可以通过各种筛选条件在存储库列表查看存储库详情。 删除存储库 用户可以根据实际情况删除或退订无用的存储库以节省成本。 绑定存储库的资源 备份存储库创建后，通过向存储库绑定服务器、文件系统或磁盘来进行备份操作。 解绑存储库的资源 当绑定的资源不再需要备份时，可以从存储库中解绑。 迁移存储库的资源 通过迁移资源功能，您可以将某个资源从当前存储库中解绑并重新绑定至另一存储库，该资源产生的所有备份也会从当前存储库迁移至目标存储库中。 扩容存储库 当用户认为存储库的总容量不足时，可以通过执行扩容操作来增加存储库的容量。 按需转包周期 如果您需要长期使用当前存储库，可以将按需购买的存储库转为包周期计费模式，节省开支。 更改云服务器备份存储库规格 云服务器备份的备份存储库分为两种规格，分别为服务器备份和数据库备份。 如果您需要备份含有数据库的服务器，需要将目标存储库的规格由服务器备份变更为数据库备份。 跨区域复制 云服务器备份存储库、SFS Turbo备份存储库和混合 云存储 备份存储库支持将整个存储库的备份复制到另一区域的复制存储库中。云服务器备份后续可在另一个区域使用复制的备份数据创建镜像，并发放新的云服务器。SFS Turbo备份后续可在另一个区域使用复制的备份创建新的文件系统。 管理存储库标签 对已创建的存储库，可对其标签进行添加、编辑或删除操作。此处的标签仅用于存储库的过滤和管理。 管理存储库企业项目 如果需要修改存储库的企业项目，可以前往企业管理界面将存储库从原企业项目中迁出至新的企业项目。 开启备份锁定 为了避免备份数据被误删除或者恶意删除，您可以通过存储库的备份锁定功能，来提升数据的安全性。 开启该功能后，您在存储库中的所有备份都将进入WORM（一次写入，多次读取）状态。处于保留期的备份数据，任何用户都不能提前删除。

存储库类型 存储库分为备份存储库、复制存储库、专属云备份存储库： 备份存储库是存放服务器和磁盘产生的备份副本的容器，备份存储库同时又分为以下几种： 云服务器备份存储库：分为两种规格，一种为仅存放普通备份的服务器备份存储库；一种为仅存放含有数据库的服务器产生的数据库备份的存储库。可以将服务器绑定至存储库并绑定自动备份或复制策略，支持将存储库中的备份复制至其他区域的复制存储库中，支持利用备份数据恢复服务器数据。 云硬盘备份存储库：仅存放磁盘备份，可以将磁盘绑定至存储库并绑定备份策略。 SFS Turbo备份存储库：仅存放SFS Turbo文件系统备份，可以将文件系统绑定至存储库并绑定备份策略。 云桌面 备份存储库：仅存放云桌面备份，可以将云桌面绑定至存储库并绑定备份策略。 复制存储库只能存放复制操作产生的备份，且由复制操作产生的备份不允许再次复制。云服务器备份的复制存储库也分为服务器备份和数据库备份两种规格。 专属云备份存储库：当用户购买专属对象存储后，可以选择将数据备份到专属存储库中，从而满足对隔离性、安全性、性能的更高要求。 已创建的存储库不支持更换保护类型，需要先删除/退订存储库后再重新创建。

操作说明 当前仅支持x86计算类型的服务器，暂不支持鲲鹏计算类型的服务器。 安装客户端时，系统会以“rdadmin”用户运行安装程序。请定期修改Agent的操作系统“rdadmin”用户的登录密码，并禁止“rdadmin”用户远程登录，以提升系统运维安全性。详情请参见修改rdadmin账号密码。 支持安装客户端的操作系统如表1所示。 表1 支持安装客户端的操作系统列表 数据库名称 操作系统类型 版本范围 SQLServer 2008/2012/2019 Windows Windows Server 2008, 2008 R2, 2012, 2012 R2, 2019 for x86_64 SQLServer 2014/2016/EE Windows Windows Server 2012, 2012 R2, 2016 Datacenter for x86_64 MySQL 5.5/5.6/5.7 Red Hat Red Hat Enterprise Linux 6, 7 for x86_64 SUSE SUSE Linux Enterprise Server 11, 12, 15 SP1, 15 SP2 for x86_64 CentOS CentOS 6, 7 for x86_64 Euler Euler OS 2.2, 2.3 for x86_64 HANA 1.0/2.0 SUSE SUSE Linux Enterprise Server 12 for x86_64 对于Windows 操作系统，需要Volume Shadow Copy 服务正常运行，才能备份成功。 支持的sha256值如表2所示。 表2 sha256值 包名 sha256值 Cloud Server Backup Agent-CentOS6-x86_64.tar.gz f0c59ccb4443bcb6e874bf6e3c574914f9f8b27f3f7379e2d81956a9972802f3 Cloud Server Backup Agent-CentOS7-x86_64.tar.gz 2d3028cb794e1699bae9f65746a60ae99be17d5c4c5e7ebe6b45ff261db9c3c7 Cloud Server Backup Agent-EulerOS2-x86_64.tar.gz 4fb4cf9cb6f5b0e6c13d8ad8bf928754cb95332ee645a97fd0bb3fcbeb53d003 Cloud Server Backup Agent-RedHat6-x86_64.tar.gz 6ae3838fb5644f0f47282c211fe20c6b57a7c5c1d683cd5a1f55860d259b2054 Cloud Server Backup Agent-RedHat7-x86_64.tar.gz 40fa68a808d9da04672678b2773e3345ea6c9dee3c17d598acb66a023cc5cacc Cloud Server Backup Agent-SuSE11-x86_64.tar.gz 346cc9f1fc0a41a817abb2db61e657a4d615449e13bc46f1c1cfbadc0b281f47 Cloud Server Backup Agent-SuSE12-x86_64.tar.gz 625279b9c9d17ddcc4210b78242efebacdad73f808b86754659d243ece85a400 Cloud Server Backup Agent-WIN64.zip b7b2067ac89f1fec635d82e3fe2ea794ce6482f9880838f34924b383be44ac4e 客户端安装时，系统会打开弹性云服务器的59526-59528端口的防火墙其中之一。当59526端口被占用时，则会打开59527端口的防火墙，以此类推。

配置强制备份策略 通过配置强制备份策略可以达到让 IAM 用户强制执行数据备份的目的，能够最大限度保障用户数据的安全性和正确性，确保业务安全。 强制备份策略配置之后，可以对IAM用户做以下限制。 在创建备份策略时，备份策略必须是开启状态。 在修改备份策略时，禁止关闭备份策略。 在创建存储库时，必须绑定备份策略。 为了确保备份强制性，建议三种策略都配置上。 目前华为云支持以下两种方式创建自定义策略： 可视化视图创建自定义策略：无需了解策略语法，按可视化视图导航栏选择云服务、操作、资源、条件等策略内容，可自动生成策略。 JSON视图创建自定义策略：可以在选择策略模板后，根据具体需求编辑策略内容；也可以直接在编辑框内编写JSON格式的策略内容。 具体创建步骤请参见：创建自定义策略。 在创建备份策略时，备份策略必须是开启状态。 { "Version": "5.0", "Statement": [ { "Effect": "Deny", "Action": ["cbr:policies:create"], "Condition": { "Bool": { "cbr:EnabledPolicy": "false" } } } ] } 在修改备份策略时，禁止关闭备份策略。 { "Version": "5.0", "Statement": [ { "Effect": "Deny", "Action": ["cbr:policies:update"], "Condition": { "Bool": { "cbr:EnabledPolicy": "false" } } } ] } 在创建存储库时，必须绑定备份策略。 { "Version": "5.0", "Statement": [ { "Effect": "Deny", "Action": [ "cbr:vaults:create" ], "Condition": { "Null": { "cbr:PolicyId": [ "true" ] } } } ] } 父主题： 管理权限

响应消息 正常响应要素说明 表2 字段说明 名称 参数类型 说明 count Integer 参数解释： SQL限流总数。 取值范围： 不涉及。 sql_limit_objects Array of objects 参数解释： SQL限流详情。 请参见表3。 表3 sql_limit_objects字段数据结构说明 名称 参数类型 说明 id String 参数解释： SQL限流ID。 取值范围： 不涉及。 query_id String 参数解释： 由SQL的语法解析树计算出的内部哈希码。 取值范围： -9223372036854775808~ 9223372036854775807。默认为0。 query_string String 参数解释： SQL语句的文本形式。 取值范围： 不涉及。 max_concurrency Integer 参数解释： 同时执行的SQL数量。 取值范围： -1~50000。小于等于0表示不限制，默认为0。 is_effective Boolean 参数解释： 是否生效。 取值范围： 不涉及。 max_waiting Integer 参数解释： 最大等待时间，单位为秒。 取值范围： 不涉及。 search_path String 参数解释： 为不是模式限定的名称设置模式搜索顺序。 取值范围： public 正常响应样例 { "count": 2, "sql_limit_objects": [ { "id": "3", "query_id": "1147616880456321454", "query_string": "select 1;", "max_concurrency": 10, "is_effective": false, "max_waiting": 10, "search_path": "public" }, { "id": "4", "query_id": "-7472493489976133824", "query_string": "select * from pg_type;", "max_concurrency": 10, "is_effective": false, "max_waiting": 10, "search_path": "public" } ] } 异常响应 请参见异常请求结果。

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/sql-limit?db_name={db_name}&offset={offset}&limit={limit} 参数说明 表1 参数说明 名称 是否必选 参数类型 说明 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 String 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 db_name 是 String 参数解释： 数据库名称。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 offset 否 Integer 参数解释： 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。 约束限制： 不涉及。 取值范围： 必须为数字，不能为负数。 默认取值： 默认为0，偏移0条数据，表示从第一条数据开始查询。 limit 否 Integer 参数解释： 查询记录数。 约束限制： 不涉及。 取值范围： 1~100 默认取值： 10

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

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 name 是 String 参数解释： 数据库账号名称。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 password 是 String 参数解释： 数据库账号密码。 约束限制： 建议您输入高强度密码，以提高安全性，防止出现密码被暴力破解等安全风险。 取值范围： 非空，密码长度在8到32个字符之间，至少包含大写字母、小写字母、数字、特殊字符~!@#$%^*-_+?,三种字符的组合，不能与账号名或倒序的账号名相同。 默认取值： 不涉及。

请求示例 修改rdsuser用户的密码。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/161e33e453954e21acfff65bfa3dbfebin04/db_user/resetpwd { "name": "rdsuser", "password": "Test@12345678" }

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

URI URI格式 GET /v3/{project_id}/instances?id={id}&name={name}&type={type}&datastore_type={datastore_type}&vpc_id={vpc_id}&subnet_id={subnet_id}&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：主备实例 Replica：只读实例 Enterprise：分布式实例（企业版） 默认取值： 不涉及。 datastore_type String 否 参数解释： 数据库类型。 约束限制： 区分大小写。 取值范围： MySQL PostgreSQL SQLServer 默认取值： 不涉及。 vpc_id String 否 参数解释： 虚拟私有云ID，获取方法如下： 方法1：登录虚拟私有云服务的控制台界面，在虚拟私有云的详情页面查找VPC ID。 方法2：通过虚拟私有云服务的API接口查询，具体操作可参考查询VPC列表。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 subnet_id String 否 参数解释： 子网的网络ID信息，获取方法如下： 方法1：登录虚拟私有云服务的控制台界面，单击VPC下的子网，进入子网详情页面，查找网络ID。 方法2：通过虚拟私有云服务的API接口查询，具体操作可参考查询子网列表。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 offset Integer 否 参数解释： 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。 约束限制： 必须为数字，不能为负数。 取值范围： 大于等于0的整数。 默认取值： 0 limit Integer 否 参数解释： 查询记录数。 约束限制： 不涉及。 取值范围： 默认为100，不能为负数，最小值为1，最大值为100。 默认取值： 100 tags Array of objects 否 参数解释： 根据实例标签键值对进行查询。 {key}表示标签键，不可以为空或重复。 {value}表示标签值，可以为空。 如果同时使用多个标签键值对进行查询，中间使用逗号分隔开，最多包含10组。 详情请参见表2。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 表2 tags字段数据结构说明 名称 参数类型 是否必选 说明 key String 是 参数解释： 标签键。 约束限制： 不涉及。 取值范围： 长度为1-128个unicode字符。 可以包含任何语种字母、数字、空格和_.:=+-@，但首尾不能含有空格，不能以_sys_开头。 默认取值： 不涉及。 value String 否 参数解释： 标签值。 约束限制： 不涉及。 取值范围： 最大长度255个unicode字符，可以为空字符串。 可以包含任何语种字母、数字、空格和_.:=+-@。 默认取值： 不涉及。

请求消息 请求参数 无。 URI样例 查询所有实例列表 GET https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/instances 根据指定条件查询实例列表 GET https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/instances?id=ed7cc6166ec24360a5ed5c5c9c2ed726in01&name=hy&type=Ha&datastore_type=MySQL&vpc_id=19e5d45d-70fd-4a91-87e9-b27e71c9891f&subnet_id=bd51fb45-2dcb-4296-8783-8623bfe89bb7&offset=0&limit=10&tags=rds001=001,rds002=002

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 users Array of objects 参数解释： 列表中每个元素表示一个数据库账号。 详情请参见表3。 total_count Integer 参数解释： 数据库用户总数。 取值范围： 不涉及。 表3 users元素结构说明 名称 参数类型 说明 name String 参数解释： 账号名。 取值范围： 不涉及。 正常响应样例 { "users": [ { "name": "rds" }, { "name": "rds001" } ], "total_count": 3 } 异常响应 请参见异常请求结果。

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/database/db_user?db-name={db-name}&page={page}&limit={limit} 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 db-name 是 参数解释： 数据库名。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 page 是 参数解释： 分页页码。 约束限制： 不涉及。 取值范围： 从1开始的正整数。 默认取值： 不涉及。 limit 是 参数解释： 每页数据条数。 约束限制： 不涉及。 取值范围： [1, 100]区间内正整数。 默认取值： 不涉及。

请求消息 表2 参数说明 参数 是否必选 参数类型 描述 db_name 是 String 参数解释： 数据库名称。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 query_id 否 Long 参数解释： 由SQL的语法解析树计算出的内部哈希码。 约束限制： 不涉及。 取值范围： -9223372036854775808~ 9223372036854775807 默认取值： 0 query_string 否 String 参数解释： SQL语句的文本形式。 约束限制： query_id与query_string只可以存在一个。 取值范围： 不涉及。 默认取值： 不涉及。 max_concurrency 是 Integer 参数解释： 同时执行的SQL数量。 约束限制： 不涉及。 取值范围： -1~50000。小于等于0表示不限制。 默认取值： 0 max_waiting 是 Integer 参数解释： 最大等待时间，单位为秒。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 search_path 否 String 参数解释： 为不是模式限定的名称设置模式搜索顺序。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： public

请求示例 新增SQL限流。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/49b9dd1d6f464ba4bc91df5cbd2e52ebin03/sql-limit { "db_name" : "postgres", "query_id" : 1, "max_concurrency" : 10, "max_waiting" : 10, "search_path" : "public" }

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

请求示例 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/a8abe84a41364097be7c233c39275087in04/db_privilege { "db_name": "rds-test", "users": [ { "name": "rds", "readonly": true }, { "name": "rds001", "readonly": false } ] }

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

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 db_name 是 String 参数解释： 数据库名称。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 users 是 Array of objects 参数解释： 每个元素都是与数据库相关联的账号。单次请求最多支持50个元素。 每个元素结构请参见表3。 表3 users列表元素数据结构说明 名称 是否必选 参数类型 说明 name 是 String 参数解释： 数据库账号名称。 约束限制： 目前不支持对不带登录名的SQL用户进行授权。 取值范围： 数据库账号名称在1到128个字符之间，不能和系统用户名称相同。 系统用户包括：rdsadmin, rdsuser, rdsbackup, rdsmirror。 默认取值： 不涉及。 readonly 否 Boolean 参数解释： 是否为只读权限。 约束限制： 不涉及。 取值范围： true：只读。 false：可读写。 默认取值： false

请求示例 复制一个新的参数模板，名称为copy_by_v31。 POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/configurations/66251c9024774eeb9edd8663a4cbb0a1pr04/copy { "name" : "copy_by_v31", "description" : "copy" }

响应消息 正常响应要素说明 表3 要素说明 名称 参数类型 说明 id String 参数解释： 参数模板ID。 取值范围： 不涉及。 name String 参数解释： 参数模板名称。 取值范围： 不涉及。 description String 参数解释： 描述。 取值范围： 不涉及。 datastore_version_name String 参数解释： 数据库版本名称。 取值范围： 不涉及。 datastore_name String 参数解释： 数据库名称。 取值范围： 不涉及。 create_time String 参数解释： 创建时间。 取值范围： 格式为“yyyy-MM-ddTHH:mm:ssZ”。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 update_time String 参数解释： 更新时间。 取值范围： 格式为“yyyy-MM-ddTHH:mm:ssZ”。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 正常响应样例 { "id" : "a73a272e50ba427397e90992fbb96f3cpr04", "name" : "copy_by_v31", "description" : "copy", "datastore_version_name" : "2017_EEmysql5.7", "datastore_name" : "sqlservermysql", "create_time" : "2022-10-31T08:24:06+0000", "update_time" : "2022-10-31T08:24:06+0000" } 异常响应 请参见异常请求结果。

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

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

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 name String 参数解释： 参数名称。 取值范围： 不涉及。 value String 参数解释： 参数值。 取值范围： 不涉及。 restart_required Boolean 参数解释： 实例是否需要重启。 取值范围： true，需要重启。 false，不需要重启。 value_range String 参数解释： 参数值范围。 取值范围： 如Integer取值0~1、Boolean取值true或false等。 type String 参数解释： 参数类型。 取值范围： 取值为“string”、“integer”、“boolean”、“list”或“float”之一。 description String 参数解释： 参数描述。 取值范围： 不涉及。 正常响应样例 { "name" : "shared_preload_libraries", "value" : "passwordcheck.so,pg_sql_history", "restart_required" : true, "value_range" : "passwordcheck.so,pg_stat_statements,pg_sql_history", "type" : "list", "description" : "Lists shared libraries to preload into server." } 异常响应 请参见异常请求结果。

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

请求示例 创建参数模板configuration_test。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/configurations { "name": "configuration_test", "description": "configuration_test", "values": { "div_precision_increment": "6", "connect_timeout": "20" }, "datastore": { "type": "mysql", "version": "5.7" } }