华为云用户手册

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 X-Language 否 String 请求语言类型。默认en-us。 取值范围： en-us zh-cn 表3 请求Body参数 参数 是否必选 参数类型 描述 source_instance_id 是 String 源实例ID。 source_node_id 否 String 源节点ID。TaurusDB只读节点ID。如为空，则取TaurusDB主节点ID。 source_database 是 String 源数据库。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 job_id String 任务ID。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 X-Language 否 String 请求语言类型。默认en-us。 取值范围： en-us zh-cn 表3 请求Body参数 参数 是否必选 参数类型 描述 dns_type 是 String 域名 类型，当前只支持private。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 Content-Type 是 String 内容类型。 取值：application/json。 X-Language 否 String 请求语言类型。默认en-us。 取值范围： en-us zh-cn

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 job_id String 任务ID。 order_id String 订单ID。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 job_id String 任务ID。 order_id String 订单ID。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

URI DELETE /mysql/v3/{project_id}/instances/{instance_id}/nodes/{node_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 String 实例ID，严格匹配UUID规则。 node_id 是 String 节点ID，严格匹配UUID规则。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 Content-Type 是 String 内容类型。 取值：application/json。 X-Language 否 String 请求语言类型。默认en-us。 取值范围： en-us zh-cn

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 Content-Type 是 String 内容类型。 取值：application/json。 X-Language 否 String 语言。 表3 请求Body参数 参数 是否必选 参数类型 描述 log_configs 是 Array of InstanceDeleteLtsConfig objects 日志配置列表。 表4 InstanceDeleteLtsConfig 参数 是否必选 参数类型 描述 instance_id 是 String 实例ID。 log_type 是 String 日志类型。

请求示例 批量删除LTS日志配置 DELETE https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/logs/lts-configs{ "log_configs" : [ { "instance_id" : "61a4ea66210545909d74a05c27a7179ein07", "log_type" : "error_log" } ]}

响应参数 状态码： 201 表11 响应Body参数 参数 参数类型 描述 instance instance object 实例信息。 job_id String 工作流ID。 表12 instance 参数 参数类型 描述 id String StarRocks实例ID，严格匹配UUID规则。 az_code String 可用区码。 az_mode String 可用区模式。 取值范围： single：单可用区。 multi：多可用区。 name String 实例名称。 engine engine object 引擎信息。 vpc_id String 虚拟私有云ID。 security_group_id String 安全组ID。 sub_net_id String 子网ID。 db_user String 数据库用户。默认root。 port Integer 数据库端口号。默认3306。 ha_mode String 部署模式。 pay_info pay_info object 计费信息。 enable_ssl Boolean SSL开关。 status String 实例状态。 region String 实例所在区域。 tags_info tags_info object 实例标签。 表13 engine 参数 参数类型 描述 type String 引擎类型。 version String 引擎大版本号。 表14 pay_info 参数 参数类型 描述 pay_model String 计费模式。 0：按需计费 1：包周期 StarRocks实例当前只支持按需计费，默认值为0 order_id String 包周期计费ID。 period String 包周期周期。 period_type String 包周期周期类型。 is_auto_renew String 包周期是否自动续费。 表15 tags_info 参数 参数类型 描述 tags Array of tags objects 用户标签。默认为空。 sys_tags Array of sys_tags objects 系统标签。 表16 tags 参数 参数类型 描述 key String 标签键。 value String 标签值。 表17 sys_tags 参数 参数类型 描述 key String 标签键。 value String 标签值。 状态码： 400 表18 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表19 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

响应示例 状态码： 201 Success. { "instance" : { "id" : "590031445ef845bb912d7fc8243db80cin17", "az_code" : "cn-southwest-244b", "az_mode" : "single", "name" : "htap-ff64", "engine" : { "type" : "star-rocks", "version" : "3.1" }, "vpc_id" : "d5a1a29b-1476-490f-9682-c1a59593e7b0", "security_group_id" : "967a0ac2-3cae-4e57-a49a-d0f6ff07dcc1", "sub_net_id" : "2ce0bc80-bfc5-4d5e-9b78-a7f91572e03b", "db_user" : "root", "port" : 3306, "ha_mode" : "Single", "pay_info" : { "pay_model" : "0", "order_id" : null, "period" : null, "period_type" : null, "is_auto_renew" : null }, "enable_ssl" : false, "status" : "creating", "region" : "cn-southwest-244", "tags_info" : { "tags" : [ ], "sys_tags" : [ { "key" : "_sys_enterprise_project_id", "value" : "0" } ] } }, "job_id" : "cf0b7506-1505-450f-9d95-ce9d93b6b5c3"}

请求示例 创建数据库实例 POST https://{endpoint}/v3/23a50154cf494ec9ad6883979a12db0a/instances/40dc4c5729f14aad893e2dcd5baf6a15in07/starrocks{ "name" : "htap-ff64", "engine" : { "type" : "star-rocks", "version" : "3.1" }, "ha" : { "mode" : "Single" }, "fe_flavor_id" : "afef3bfd-ac7c-32e1-ba44-c388acbb196a", "be_flavor_id" : "de565db8-0a96-37ea-9388-61167624712c", "db_root_pwd" : "Test@123!", "fe_count" : 1, "be_count" : 1, "az_mode" : "single", "fe_volume" : { "io_type" : "SSD", "capacity_in_gb" : 50 }, "be_volume" : { "io_type" : "SSD", "capacity_in_gb" : 50 }, "az_code" : "cn-southwest-244b", "time_zone" : "UTC+08:00", "tags_info" : { "sys_tags" : [ { "key" : "_sys_enterprise_project_id", "value" : "0" } ] }}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 Content-Type 是 String 内容类型。 取值：application/json。 X-Language 否 String 请求语言类型。默认en-us。 取值范围： en-us zh-cn 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 实例名称。同一租户下，同类型的实例名可重名。 取值范围：最小为4个字符，最大为64个字符且不超过64个字节，必须以字母开头，区分大小写，可以包含字母、数字、中划线、下划线，不能包含其他特殊字符。不支持中文名。 engine 是 engine object 引擎信息。 ha 是 ha object 部署信息。 fe_flavor_id 是 String FE节点规格ID。使用可通过查询HTAP规格响应消息中的“id”。 be_flavor_id 是 String BE节点规格ID。使用可通过查询HTAP规格响应消息中的“id”。 db_root_pwd 是 String 数据库密码。 取值范围：至少包含以下字符的三种：大小写字母、数字和特殊符号~!@#$%^*-_=+?,()&|.，长度8~32个字符。 建议您输入高强度密码，以提高安全性，防止出现密码被暴力破解等安全风险。如果您输入弱密码，系统会自动判定密码非法。 fe_count 是 Integer FE节点数。 单机时固定为1 集群时取值[3, 10] be_count 是 Integer BE节点数。 单机时固定为1 集群时取值[3, 10] az_mode 是 String 可用区类型。 当前仅支持single。 fe_volume 是 fe_volume object FE节点存储规格。 be_volume 是 be_volume object BE节点存储规格。 az_code 是 String 可用区代码。 time_zone 否 String 时区。默认时区为UTC+08:00。 tags_info 是 tags_info object 标签信息。 security_group_id 否 String 实例安全组ID。默认与Taurus安全组ID一致。 pay_info 否 pay_info object 支付信息。包周期场景必填。 region_code 否 String 可用区。包周期场景必填。 表4 engine 参数 是否必选 参数类型 描述 type 是 String 引擎类型。仅支持star-rocks。 version 是 String 引擎大版本号。 表5 ha 参数 是否必选 参数类型 描述 mode 是 String 部署模式。 表6 fe_volume 参数 是否必选 参数类型 描述 io_type 是 String 磁盘类型。通过查询HTAP引擎资源返回消息获取。 capacity_in_gb 是 Integer 磁盘容量，单位GB 增长的步长：10GB。 表7 be_volume 参数 是否必选 参数类型 描述 io_type 是 String 磁盘类型。通过查询HTAP引擎资源返回消息获取。 capacity_in_gb 是 Integer 磁盘容量，单位GB 增长的步长：10GB。 表8 tags_info 参数 是否必选 参数类型 描述 sys_tags 是 Array of sys_tags objects 系统标签。 表9 sys_tags 参数 是否必选 参数类型 描述 key 是 String 标签键。 value 是 String 标签值。 表10 pay_info 参数 是否必选 参数类型 描述 pay_model 否 String 计费模式，默认0。包周期场景必填。 取值范围： 0：按需计费 1：包周期 period 否 String 包周期周期。包周期场景必填。 period_type 否 String 包周期周期类型。包周期场景必填。 取值范围： 2：包月 3：包年 is_auto_renew 否 String 包周期是否自动续费。包周期场景必填。 取值范围： 1：自动续费 0：不自动续费

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

请求示例 创建数据库用户，读写权限，主机IP地址是127.0.0.1。 POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/a23fb62bd61e4e9e9636fd2225f395bein07/db-users{ "users" : [ { "name" : "gaussdb_mysql_user1", "password" : "***", "hosts" : [ "127.0.0.1" ], "comment" : "database_user_comment", "databases" : [ { "name" : "test", "readonly" : false } ] } ]}

响应参数 状态码： 201 表6 响应Body参数 参数 参数类型 描述 job_id String 参数解释: 创建数据库用户的任务ID。 取值范围： 符合UUID规则。 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

URI DELETE /v3/{project_id}/instances/{instance_id}/clickhouse/databases/replication/config 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一Region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 String ClickHouse实例ID，严格匹配UUID规则。 表2 Query参数 参数 是否必选 参数类型 描述 database 是 String 数据库名。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 job_id String 创建的任务ID。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 job_id String 任务ID。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

请求示例 创建实例 POST https://{endpoint}/mysql/v3/054e292c9880d4992f02c0196d3ea468/instances{ "name" : "gaussdb-mysql-instance1", "region" : "br-iaas-odin1", "charge_info" : { "charge_mode" : "postPaid" }, "datastore" : { "type" : "gaussdb-mysql", "version" : "8.0" }, "mode" : "Cluster", "flavor_ref" : "gaussdb.mysql.large.x86.4", "vpc_id" : "3cedfc54-b105-4652-a4e0-847b11576b58", "subnet_id" : "c1cfa53c-65d3-431e-8552-326bf310c7ad", "security_group_id" : "fc577a1a-f202-424a-977f-24faec3fdd55", "configuration_id" : "43570e0de32e40c5a15f831aa5ce4176pr07", "password" : "Hu2wei@13", "backup_strategy" : { "start_time" : "08:00-09:00" }, "availability_zone_mode" : "single", "slave_count" : 1, "enterprise_project_id" : 0}

响应示例 状态码： 201 Success. { "instance" : { "id" : "5eebbb4c0f9f4a99b42ed1b6334569aain07", "name" : "gaussdb-mysql-instance1", "status" : "BUILD", "region" : "br-iaas-odin1", "charge_info" : { "charge_mode" : "postPaid" }, "datastore" : { "type" : "gaussdb-mysql", "version" : "8.0", "kernel_version" : "2.0.51.240300" }, "mode" : "Cluster", "port" : "3306", "enterprise_project_id" : "0", "flavor_ref" : "gaussdb.mysql.large.x86.4", "vpc_id" : "3cedfc54-b105-4652-a4e0-847b11576b58", "subnet_id" : "c1cfa53c-65d3-431e-8552-326bf310c7ad", "security_group_id" : "fc577a1a-f202-424a-977f-24faec3fdd55", "configuration_id" : "43570e0de32e40c5a15f831aa5ce4176pr07", "backup_strategy" : { "start_time" : "08:00-09:00", "keep_days" : 7 }, "availability_zone_mode" : "single", "slave_count" : 1 }, "job_id" : "dff1d289-4d03-4942-8b9f-463ea07c000d"}

响应参数 状态码： 201 表9 响应Body参数 参数 参数类型 描述 instance MysqlInstanceResponse object 实例信息 job_id String 实例创建的任务id。 仅创建按需实例时会返回该参数。 order_id String 订单号，创建包年包月时返回该参数。 表10 MysqlInstanceResponse 参数 参数类型 描述 id String 实例ID。 name String 实例名称。用于表示实例的名称，同一租户下，同类型的实例名称可相同。 取值范围：4~64个字符之间，必须以字母开头，不区分大小写，可以包含字母、数字、中划线或者下划线, 不能包含其它的特殊字符。 status String 实例状态。 datastore MysqlDatastore object 数据库信息。 mode String 实例类型，仅支持Cluster。 configuration_id String 参数组ID。 port String 数据库端口信息。 backup_strategy MysqlBackupStrategy object 自动备份策略 enterprise_project_id String 企业项目ID。 region String 区域ID，与请求参数相同。 availability_zone_mode String 可用区模式，与请求参数相同。 master_availability_zone String 主可用区ID。 vpc_id String 虚拟私有云ID，与请求参数相同。 security_group_id String 安全组ID，与请求参数相同。 subnet_id String 子网ID，与请求参数相同。 flavor_ref String 规格码，与请求参数相同。 charge_info MysqlChargeInfo object 计费类型信息，支持包年包月和按需，默认为按需。 表11 MysqlDatastore 参数 参数类型 描述 type String 数据库引擎，现在只支持gaussdb-mysql version String 数据库版本。 数据库支持的详细版本信息，可调用查询数据库引擎的版本接口获取。 kernel_version String 内核数据库版本。如果需要指定具体的内核版本，请联系客服人员添加白名单。 表12 MysqlBackupStrategy 参数 参数类型 描述 start_time String 自动备份开始时间段。自动备份将在该时间一个小时内触发。 取值范围：非空，格式必须为hh:mm-HH:MM且有效，当前时间指UTC时间。 HH取值必须比hh大1。 mm和MM取值必须相同，且取值必须为00。 keep_days String 自动备份保留天数，取值范围：1-732 表13 MysqlChargeInfo 参数 参数类型 描述 charge_mode String 计费模式。 取值范围： prePaid：预付费，即包年/包月。 postPaid：后付费，即按需付费。 枚举值： prePaid postPaid period_type String 订购周期类型。 取值范围： month：包月。 year：包年。 说明：“charge_mode”为“prePaid”时生效，且为必选值。 枚举值： month year period_num Integer “charge_mode”为“prePaid”时生效，且为必选值，指定订购的时间。 取值范围： 当“period_type”为“month”时，取值为1~9。 当“period_type”为“year”时，取值为1~3。 is_auto_renew String 创建包周期实例时可指定，表示是否自动续订，续订的周期和原周期相同，且续订时会自动支付。 true，为自动续订。 false，为不自动续订，默认该方式。 枚举值： true false is_auto_pay String 创建包周期时可指定，表示是否自动从客户的账户中支付，此字段不影响自动续订的支付方式。 true，为自动支付，默认该方式。 false，为手动支付。 枚举值： true false 状态码： 400 表14 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表15 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 Content-Type 是 String 内容类型。 取值：application/json。 X-Language 否 String 请求语言类型。默认en-us。 取值范围： en-us zh-cn 表3 请求Body参数 参数 是否必选 参数类型 描述 charge_info 否 MysqlChargeInfo object 计费类型信息，支持包年包月和按需，默认为按需。 说明：DeC专属云账号不支持创建包周期。 region 是 String 区域ID。 name 是 String 实例名称。用于表示实例的名称，同一租户下，同类型的实例名可重名。 取值范围：最小为4个字符，最大为64个字符且不超过64个字节（注意：一个中文字符占用3个字节），必须以字母或中文开头，区分大小写，可以包含字母、数字、中划线、下划线或中文，不能包含其他特殊字符。 datastore 是 MysqlDatastore object 数据库信息。 mode 是 String 实例类型，目前仅支持Cluster。 flavor_ref 是 String 规格码。使用可参考查询数据库规格响应消息表5中的“spec_code”。 vpc_id 是 String 虚拟私有云ID，获取方法如下： 方法1：登录虚拟私有云服务的控制台界面，在虚拟私有云的详情页面查找VPC ID。 方法2：通过虚拟私有云服务的API接口查询，具体操作可参考查询VPC列表。 subnet_id 是 String 子网的网络ID，获取方法如下： 方法1：登录虚拟私有云服务的控制台界面，单击VPC下的子网，进入子网详情页面，查找网络ID。 方法2：通过虚拟私有云服务的API接口查询，具体操作可参考查询子网列表。 security_group_id 否 String 安全组ID。如果实例所选用的子网开启网络ACL进行访问控制，则该参数非必选。如果未开启ACL进行访问控制，则该参数必选。 configuration_id 否 String 参数模板ID。 password 是 String 数据库密码。 取值范围：至少包含以下字符的三种：大小写字母、数字和特殊符号|.~!@#$%^*-_=+?,()&，长度8~32个字符。 建议您输入高强度密码，以提高安全性，防止出现密码被暴力破解等安全风险。如果您输入弱密码，系统会自动判定密码非法。 backup_strategy 否 MysqlBackupStrategy object 自动备份策略 time_zone 否 String 时区。 availability_zone_mode 是 String 可用区类型,单可用区Single或多可用区multi。 master_availability_zone 否 String 主可用区。 slave_count 是 Integer 备节点个数。单次接口调用最多支持创建9个备节点。 volume 否 MysqlVolume object volume信息。创建包周期实例可选。 tags 否 Array of MysqlTags objects 标签列表，根据标签键值对创建实例。 {key}表示标签键，不可以为空或重复。 {value}表示标签值，可以为空。 如果创建实例时同时使用多个标签键值对，中间使用逗号分隔开，最多包含10组。 enterprise_project_id 否 String 企业项目ID。如果账户开通企业项目服务则该参数必选，未开启该参数不可选。 dedicated_resource_id 否 String 专属资源池ID，只有开通专属资源池后才可以下发此参数。 表4 MysqlChargeInfo 参数 是否必选 参数类型 描述 charge_mode 是 String 计费模式。 取值范围： prePaid：预付费，即包年/包月。 postPaid：后付费，即按需付费。 枚举值： prePaid postPaid period_type 否 String 订购周期类型。 取值范围： month：包月。 year：包年。 说明：“charge_mode”为“prePaid”时生效，且为必选值。 枚举值： month year period_num 否 Integer “charge_mode”为“prePaid”时生效，且为必选值，指定订购的时间。 取值范围： 当“period_type”为“month”时，取值为1~9。 当“period_type”为“year”时，取值为1~3。 is_auto_renew 否 String 创建包周期实例时可指定，表示是否自动续订，续订的周期和原周期相同，且续订时会自动支付。 true，为自动续订。 false，为不自动续订，默认该方式。 枚举值： true false is_auto_pay 否 String 创建包周期时可指定，表示是否自动从客户的账户中支付，此字段不影响自动续订的支付方式。 true，为自动支付，默认该方式。 false，为手动支付。 枚举值： true false 表5 MysqlDatastore 参数 是否必选 参数类型 描述 type 是 String 数据库引擎，现在只支持gaussdb-mysql version 是 String 数据库版本。 数据库支持的详细版本信息，可调用查询数据库引擎的版本接口获取。 kernel_version 否 String 内核数据库版本。如果需要指定具体的内核版本，请联系客服人员添加白名单。 完整的四位内核数据库版本，获取方法请参见查询数据库引擎的版本返回的kernel_version字段。 表6 MysqlBackupStrategy 参数 是否必选 参数类型 描述 start_time 是 String 自动备份开始时间段。自动备份将在该时间一个小时内触发。 取值范围：非空，格式必须为hh:mm-HH:MM且有效，当前时间指UTC时间。 HH取值必须比hh大1。 mm和MM取值必须相同，且取值必须为00。 keep_days 否 String 自动备份保留天数，取值范围：1-732 表7 MysqlVolume 参数 是否必选 参数类型 描述 size 是 String 磁盘大小。默认值为10，单位GB。 取值范围：10~128000，必须为10的整数倍。 表8 MysqlTags 参数 是否必选 参数类型 描述 key 是 String 标签键。最大长度36个unicode字符。 key不能为空或者空字符串，不能为空格。 字符集：A-Z，a-z ，0-9，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。 value 是 String 标签值。最大长度43个unicode字符。 可以为空字符串。 字符集：A-Z，a-z ，0-9，‘.’，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。

响应参数 状态码： 202 表5 响应Body参数 参数 参数类型 描述 job_id String 删除数据库用户的任务ID。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

请求示例 删除主机地址是"127.0.0.1"的数据库用户。 DELETE https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/a23fb62bd61e4e9e9636fd2225f395bein07/db-users{ "users" : [ { "name" : "gaussdb_mysql_user1", "host" : "127.0.0.1" } ]}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 X-Language 否 String 请求语言类型。默认en-us。 取值范围： en-us zh-cn 表3 请求Body参数 参数 是否必选 参数类型 描述 users 是 Array of ListDeleteDatabaseUserRequest objects 准备删除的数据库用户列表，列表最大长度为50。 表4 ListDeleteDatabaseUserRequest 参数 是否必选 参数类型 描述 name 是 String 数据库用户名。 host 是 String 主机地址。

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 job_id String 任务ID。 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

请求示例 表级时间点恢复。 POST https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/instances/61a4ea66210545909d74a05c27a7179ein07/backups/restore/tables{ "restore_time" : 1690890940000, "last_table_info" : true, "restore_tables" : [ { "database" : "test_db_1", "tables" : [ { "new_name" : "t3_1690899914000", "old_name" : "t3" } ] } ]}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释： 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 约束限制： 不涉及。 取值范围： 不涉及。 默认值： 不涉及。 X-Language 否 String 参数解释： 请求语言类型。 约束限制： 不涉及。 取值范围： en-us zh-cn 默认值： en-us。 表3 请求Body参数 参数 是否必选 参数类型 描述 restore_time 是 String 参数解释： 备份时间点。 约束限制： 格式为UNIX时间戳，单位是毫秒，时区为UTC标准时区。传参时需要将对应时区的时间转为标准时区对应的时间戳，比如，北京时区的时间点需要-8h后再转为时间戳。 取值范围： 通过查询可恢复时间段获取。 默认取值： 不涉及。 restore_tables 是 Array of CreateRestoreDatabaseTableInfo objects 数据库信息。 last_table_info 否 String 参数解释： 是否是最新库表。 约束限制： 不涉及。 取值范围： true：是最新库表。 false：是恢复时间点库表。 默认取值： false。 表4 CreateRestoreDatabaseTableInfo 参数 是否必选 参数类型 描述 database 是 String 参数解释： 数据库名称。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： false。 tables 是 Array of CreateRestoreTableInfo objects 表信息。 表5 CreateRestoreTableInfo 参数 是否必选 参数类型 描述 old_name 是 String 参数解释： 恢复前表名。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： false。 new_name 是 String 参数解释： 恢复后表名。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： false