华为云用户手册

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 proxy MysqlProxy object Proxy实例信息。 master_node MysqlProxyNode object 主节点信息。 readonly_nodes Array of MysqlProxyNode objects 只读节点信息。 表4 MysqlProxy 参数 参数类型 描述 pool_id String Proxy实例id。 status String Proxy实例开启状态。 取值范围：closed、open、frozen、opening、closing、enlarging、freezing和unfreezing。 address String Proxy读写分离地址。 port Integer Proxy端口信息。 pool_status String Proxy实例状态。 取值范围：ACTIVE、BUILD、FAILED和DELETED。 delay_threshold_in_seconds Integer 延时阈值，单位：秒。 elb_vip String Elb模式的虚拟ip信息。 eip String 弹性公网IP信息。 vcpus String Proxy实例规格的CPU数量。 ram String Proxy实例规格的内存数量。 node_num Integer Proxy节点个数。 mode String Proxy主备模式，取值范围：Cluster。 nodes Array of MysqlProxyNodes objects Proxy节点信息。 flavor_ref String Proxy规格信息。 name String Proxy实例名称。 表5 MysqlProxyNodes 参数 参数类型 描述 id String Proxy节点id。 status String Proxy节点状态。 取值范围：ACTIVE、ABNORMAL、BUILD和FAILED。 name String Proxy节点名称。 role String Proxy节点角色：master和slave。 az_code String 可用区。 frozen_flag Integer Proxy节点是否被冻结：0-未冻结；1-冻结；2-冻结删除。 表6 MysqlProxyNode 参数 参数类型 描述 id String 节点id。 instance_id String 实例id。 status String 节点状态。 name String 节点名称。 weight Integer 节点读写分离读权重。 available_zones Array of MysqlProxyAvailable objects 可用区信息。 表7 MysqlProxyAvailable 参数 参数类型 描述 code String 可用区编码。 description String 可用区描述。 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

响应示例 状态码： 200 Success. { "proxy" : { "pool_id" : "2e7cf21d14794bafab623a334efd9ad8po01", "status" : "open", "address" : "192.168.125.69", "port" : 3306, "pool_status" : "ACTIVE", "delay_threshold_in_seconds" : 30, "elb_vip" : "192.168.125.60", "eip" : "192.168.125.50", "vcpus" : 4, "ram" : 8, "node_num" : 2, "mode" : "Cluster", "nodes" : { "id" : "db53a238a02240c49365e72e284a4890pn01", "name" : "PROXY-2e7cf21d14794bafab623a334efd9ad8po01_0", "role" : "master", "az_code" : "az1xahz", "status" : "ACTIVE", "frozen_flag" : 0 }, "name" : "proxy-name" }, "master_node" : { "id" : "5ee8010ab992460d8d9cffcc5edabb59no07", "instance_id" : "7a871d6d494e4327ad2e326afb591108in07", "status" : "ACTIVE", "name" : "taurus_mysql80_x86-ondemand-2-1U4G_1_202103070251274842281_node01", "weight" : 0, "available_zones" : { "code" : "az1", "description" : "可用区1" } }, "readonly_nodes" : { "id" : "d23535333138462880bfa1838fdfced2no07", "instance_id" : "7a871d6d494e4327ad2e326afb591108in07", "status" : "ACTIVE", "name" : "taurus_mysql80_x86-ondemand-2-1U4G_1_202103070251274842281_node02", "weight" : 100, "available_zones" : { "code" : "az1", "description" : "可用区1" } }}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 X-Language 否 String 语言。 表3 请求Body参数 参数 是否必选 参数类型 描述 action 是 String 操作标识，取值： create，表示添加标签。 delete，表示删除标签。 tags 是 Array of TagItem objects 标签列表。 表4 TagItem 参数 是否必选 参数类型 描述 key 是 String 标签键。最大长度36个unicode字符，不能为null或者空字符串，不能为空格。 字符集：0-9，A-Z，a-z，“_”，“-”，中文。 value 否 String 标签值。最大长度43个unicode字符，可以为空字符串，不能为空格。 字符集：0-9，A-Z，a-z，“_”，“.”，“-”，中文。 “action”值为“create”时，该参数必选。 “action”值为“delete”时，如果value有值，按照key-value删除，如果value没值，则按照key删除。

请求示例 批量添加标签。 POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/61a4ea66210545909d74a05c27a7179ein07/tags/action{ "action" : "create", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value2" } ]} 批量删除标签。 POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/61a4ea66210545909d74a05c27a7179ein07/tags/action{ "action" : "delete", "tags" : [ { "key" : "key1" }, { "key" : "key2", "value" : "value2" } ]}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 X-Language 否 String 语言。 表3 请求Body参数 参数 是否必选 参数类型 描述 users 是 Array of GrantDatabasePermission objects 数据库用户列表，列表最大长度为50。 表4 GrantDatabasePermission 参数 是否必选 参数类型 描述 name 是 String 数据库用户名。 host 是 String 主机地址。 databases 是 Array of DatabasePermission objects 数据库权限列表，列表最大长度为50。 表5 DatabasePermission 参数 是否必选 参数类型 描述 name 是 String 数据库名称。 readonly 是 Boolean 是否为只读权限： true，表示只读。 false，表示可读写。

请求示例 授予数据库用户数据库读写权限。 POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/a23fb62bd61e4e9e9636fd2225f395bein07/db-users/privilege{ "users" : [ { "name" : "gaussdb_mysql_user1", "host" : "127.0.0.1", "databases" : [ { "name" : "test", "readonly" : false } ] } ]}

响应参数 状态码： 201 表6 响应Body参数 参数 参数类型 描述 job_id String 授予用户权限的任务ID。 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 job_ids Array of strings 任务ID，表示成功取消定时调度任务的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 错误消息。

监控指标 表1 监控指标说明 指标 指标名称 含义 取值范围 备注 gaussdb_mysql001_cpu_util CPU使用率 该指标用于统计测量对象的CPU利用率。 0～100% 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql002_mem_util 内存使用率 该指标用于统计测量对象的内存利用率。 0～100% 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql004_bytes_in 网络输入吞吐量 该指标用于统计平均每秒从测量对象的所有网络适配器输入的流量。 ≥0 Bytes/s 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql005_bytes_out 网络输出吞吐量 该指标用于统计平均每秒从测量对象的所有网络适配器输出的流量。 ≥0 Bytes/s 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql006_conn_count 数据库总连接数 该指标用于统计连接到MySQL服务器的总连接数。 ≥0 Connections 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql007_conn_active_count 当前活跃连接数 该指标用于统计当前活跃的连接数。 ≥0 Connections 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql008_qps QPS 该指标用于统计SQL语句查询次数，包含DDL，DML，SHOW语句，SET语句和存储过程。 ≥0 Times/s 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql009_tps TPS 该指标用于统计平均每秒事务执行次数，包含提交的和回退的。 ≥0 Times/s 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql010_innodb_buf_usage 缓冲池利用率 该指标用于统计使用的页与InnoDB缓存中数据页总数比例。 0～100% 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql011_innodb_buf_hit 缓冲池命中率 该指标用于统计该段时间读命中与读请求数比例。 0～100% 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql012_innodb_buf_dirty 缓冲池脏块率 该指标用于统计InnoDB缓存中脏数据与数据比例。 0～100% 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql013_innodb_reads InnoDB读取吞吐量 该指标用于统计Innodb平均每秒读字节数。 ≥0 Bytes/s 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql014_innodb_writes InnoDB写入吞吐量 该指标用于统计Innodb平均每秒写字节数。 ≥0 Bytes/s 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql017_innodb_log_write_req_count InnoDB日志写请求频率 该指标用于统计平均每秒的日志写请求数。 ≥0 Requests/s 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql020_temp_tbl_count 临时表数量 该指标用于统计MySQL执行语句时在硬盘上自动创建的临时表的数量。 ≥0 Tables 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql028_comdml_del_count Delete语句执行频率 该指标用于统计平均每秒Delete语句执行次数。 ≥0 Statements/s 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql029_comdml_ins_count Insert语句执行频率 该指标用于统计平均每秒Insert语句执行次数。 ≥0 Statements/s 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql030_comdml_ins_sel_count Insert_Select语句执行频率 该指标用于统计平均每秒Insert_Select语句执行次数。 ≥0 Statements/s 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql031_comdml_rep_count Replace语句执行频率 该指标用于统计平均每秒Replace语句执行次数。 ≥0 Statements/s 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql032_comdml_rep_sel_count Replace_Selection语句执行频率 该指标用于统计平均每秒Replace_Selection语句执行次数。 ≥0 Statements/s 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql033_comdml_sel_count Select语句执行频率 该指标用于统计平均每秒Select语句执行次数。 ≥0 Statements/s 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql034_comdml_upd_count Update语句执行频率 该指标用于统计平均每秒Update语句执行次数。 ≥0 Statements/s 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql035_innodb_del_row_count 行删除速率 该指标用于统计平均每秒从InnoDB表删除的行数。 ≥0 Rows/s 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql036_innodb_ins_row_count 行插入速率 该指标用于统计平均每秒向InnoDB表插入的行数。 ≥0 Rows/s 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql037_innodb_read_row_count 行读取速率 该指标用于统计平均每秒从InnoDB表读取的行数。 ≥0 Rows/s 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql038_innodb_upd_row_count 行更新速率 该指标用于统计平均每秒向InnoDB表更新的行数。 ≥0 Rows/s 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql048_disk_used_size 磁盘使用量 该指标用于统计测量对象的磁盘使用大小。 0GB～128TB 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql072_conn_usage 连接数使用率 该指标用于统计当前已用的MySQL连接数占最大连接数的百分比。 0~100% 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql074_slow_queries 慢日志个数统计 该指标展示每分钟MySQL产生慢日志的数量。 ≥0 Queries/min 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql077_replication_delay 数据同步延迟 该指标用于采集主备实例的数据同步延迟时间。 ≥0 s 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql104_dfv_write_delay 存储写时延 该指标用于统计某段时间写入数据到存储层的平均时延。 ≥0 ms 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql105_dfv_read_delay 存储读时延 该指标用于统计某段时间从存储层读取数据的平均时延。 ≥0 ms 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql106_innodb_row_lock_current_waits InnoDB行锁数量 该指标用于采集InnoDB表上的操作当前正在等待的行锁数量。 ≥0 Locks 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql107_comdml_ins_and_ins_sel_count Insert和Insert_Select语句执行频率 该指标用于统计平均每秒Insert和Insert_Select语句的执行次数。 ≥0 Statements/s 测量对象：弹性云服务器 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql108_com_commit_count Commit语句执行频率 该指标用于统计平均每秒Commit语句的执行次数。 ≥0 Statements/s 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql109_com_rollback_count Rollback语句执行频率 该指标用于统计平均每秒Rollback语句的执行次数。 ≥0 Statements/s 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql110_innodb_bufpool_reads InnoDB存储层读请求频率 该指标用于统计平均每秒InnoDB从存储层读取数据的请求次数。 ≥0 Times/s 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql111_innodb_bufpool_read_requests InnoDB读请求频率 该指标用于统计平均每秒InnoDB读取数据的请求次数。 ≥0 Requests/s 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql114_innodb_bufpool_read_ahead innodb顺序预读页数 该指标用于统计innodb顺序预读页数。 ≥0 Pages 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql115_innodb_bufpool_read_ahead_evicted innodb顺序预读，但未访问过的页数 该指标用于统计innodb顺序预读，但未访问过的页数。 ≥0 Pages 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql116_innodb_bufpool_read_ahead_rnd innodb随机预读页数 该指标用于统计innodb随机预读页数。 ≥0 Read-aheads 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql117_innodb_pages_read innodb读取物理page的数量 该指标用于统计innodb读取物理page的数量。 ≥0 Pages 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql118_innodb_pages_written innodb写入物理page的数量 该指标用于统计innodb写入物理page的数量。 ≥0 Pages 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql019_innodb_log_writess innodb log buffer写入log file的总次数 该指标用于统计对InnoDB redo log文件的物理写入次数。 ≥0 Writes 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql342_iostat_iops_write IO写IOPS 该指标用于采集磁盘每秒写次数。 ≥0 Operations/s 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql344_iostat_iops_read IO读IOPS 该指标用于采集磁盘每秒读次数。 ≥0 Operations/s 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql346_iostat_throughput_write IO写带宽 该指标用于采集磁盘每秒写带宽。 ≥0 Bytes/s 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql348_iostat_throughput_read IO读带宽 该指标用于采集磁盘每秒读带宽。 ≥0 Bytes/s 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 gaussdb_mysql119_disk_used_ratio 磁盘使用率 该指标用于统计磁盘的使用率。 0~100% 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 1分钟 gaussdb_mysql371_taurus_binlog_total_file_counts Binlog文件个数 该指标用于统计GaussDB(for MySQL)Binlog文件数量。 ≥0 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 5分钟 gaussdb_mysql378_create_temp_tbl_per_min 临时表每分钟创建数 该指标用于统计GaussDB(for MySQL)执行语句时在硬盘上每分钟自动创建的临时表的数量。 ≥0 counts/min 测量对象：数据库 监控实例类型：GaussDB(for MySQL)实例 1分钟

URI PUT /v3/{project_id}/instances/{instance_id}/proxy/{proxy_id}/flavor 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 String 实例ID，严格匹配UUID规则。 proxy_id 是 String 数据库代理ID，严格匹配UUID规则。

响应参数 状态码： 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 错误消息。

请求示例 变更数据库代理的规格为4U8GB。 PUT https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/61a4ea66210545909d74a05c27a7179ein07/proxy/e87088f0b6a345e79db19d57c41fde15po01/flavor{ "flavor_ref" : "gaussdb.proxy.xlarge.arm.2"}

请求示例 变更实例的内存规格为4U32GB。 POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/ba62a0b83a1b42bfab275829d86ac0fdin07/action{ "resize_flavor" : { "spec_code" : "gaussdb.mysql.xlarge.arm.4" }}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 X-Language 否 String 语言。 表3 请求Body参数 参数 是否必选 参数类型 描述 resize_flavor 是 MysqlResizeFlavor object 规格变更信息。 is_auto_pay 否 String 变更包周期实例规格时可指定，表示是否自动从客户的账户中支付。 true，为自动支付，默认该方式。 false，为手动支付。 表4 MysqlResizeFlavor 参数 是否必选 参数类型 描述 spec_code 是 String 规格码

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 job_id String 规格变更的任务ID，仅变更按需实例时会返回该参数 order_id String 订单ID，仅变更包周期实例时会返回该参数 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 configurations ConfigurationSummary2 object 参数模板信息。 表6 ConfigurationSummary2 参数 参数类型 描述 id String 参数组ID。 name String 参数组名称。 description String 参数组描述。 datastore DatastoreResult object 数据库对象。 created String 创建时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量。 updated String 更新时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量。 表7 DatastoreResult 参数 参数类型 描述 type String 数据库引擎，现在只支持gaussdb-mysql version String 数据库版本。数据库支持的详细版本信息，可调用查询数据库引擎的版本接口获取。 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

请求示例 创建参数模板，帐户允许最大同时连接数为10。 POST https://{endpoint}/v3/056538411200d4cd2f79c003c7606412/configurations{ "name" : "myparameter", "description" : "parameter1", "datastore" : { "type" : "gaussdb-mysql", "version" : "8.0" }, "parameter_values" : { "max_user_connections" : "10" }}

响应示例 状态码： 200 Success. { "configurations" : { "id" : "887ea0d1bb0843c49e8d8e5a09a95652pr07", "name" : "myparameter", "description" : "parameter1", "datastore" : { "type" : "gaussdb-mysql", "version" : "8.0" }, "created" : "2022-05-15T11:53:34+0000", "updated" : "2022-05-15T11:53:34+0000" }}

响应示例 状态码： 201 Success. { "backup" : { "id" : "2f4ddb93-b901-4b08-93d8-1d2e472f30fe", "name" : "backup-1", "description" : "手动备份", "begin_time" : "2020-07-07T01:17:05+0800", "status" : "BUILDING", "type" : "manual", "instance_id" : "ef25188419f941309882d2986b2210b9in07" }, "job_id" : "e0fbbfc8-1ac4-4721-b9e9-7dd685c5bdd7"}

响应参数 状态码： 201 表4 响应Body参数 参数 参数类型 描述 backup backup object 备份信息。 job_id String 任务ID。 表5 backup 参数 参数类型 描述 id String 备份ID name String 备份名称。 description String 备份描述。 begin_time String 备份开始时间，格式为“yyyy-mm-ddThh:mm:ssZ”，其中T指时间字段的开始；Z指时区偏移量。 status String 备份状态，取值： BUILDING：备份中。 COMPLETED：备份完成。 FAILED：备份失败。 AVAILABLE：备份可用。 枚举值： BUILDING COMPLETED FAILED AVAILABLE type String 备份类型，取值： manual：手动全量备份。 枚举值： manual instance_id String 实例ID。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

请求示例 创建数据库，字符集为utf8mb4，读写权限。 POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/a23fb62bd61e4e9e9636fd2225f395bein07/databases{ "databases" : [ { "name" : "test", "character_set" : "utf8mb4", "comment" : "database_comment", "users" : [ { "name" : "gaussdb_mysql_user1", "host" : "127.0.0.1", "readonly" : false } ] } ]}

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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token X-Language 否 String 语言 表3 请求Body参数 参数 是否必选 参数类型 描述 resize_flavor 是 MysqlResizeFlavor object 规格变更信息。 is_auto_pay 否 String 变更包周期实例规格时可指定，表示是否自动从客户的账户中支付。true，为自动支付，默认该方式。false，为手动支付。 表4 MysqlResizeFlavor 参数 是否必选 参数类型 描述 spec_code 是 String 规格码

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 job_id String 规格变更的任务id，仅变更按需实例时会返回该参数 order_id String 订单id，仅变更包周期实例时会返回该参数 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

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

请求示例 创建数据库用户，读写权限，主机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 } ] } ]}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 X-Language 否 String 语言。 表3 请求Body参数 参数 是否必选 参数类型 描述 priorities 是 Array of integers 指定创建的只读节点故障倒换优先级。 故障倒换优先级的取值范围为1~16，数字越小，优先级越大，即故障倒换时，主节点会优先倒换到优先级高的只读节点上，优先级相同的只读节点选为主节点的概率相同。最多支持9个只读节点设置故障倒换优先级，超过9个的只读节点优先级默认为-1，表示不会参与倒换。可通过修改节点的故障倒换优先级来进行调整。 is_auto_pay 否 String 创建包周期时可指定，表示是否自动从客户的账户中支付，此字段不影响自动续订的支付方式。 true，为自动支付，默认该方式。 false，为手动支付。

响应参数 状态码： 201 表4 响应Body参数 参数 参数类型 描述 instance_id String 实例ID。 node_names Array of strings 节点名称列表。 job_id String 创建只读节点的任务ID。 仅创建按需只读节点时会返回该参数。 order_id String 订单号，创建包年包月只读节点时返回该参数。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

请求示例 开启数据库代理，代理实例规格2U8GB，代理模式只读模式。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/43e4feaab48f11e89039fa163ebaa7e4br01/proxy{ "flavor_ref" : "gaussdb.mysql.large.x86.4", "node_num" : 2, "proxy_name" : "gaussdb-proxy", "proxy_mode" : "readonly", "nodes_read_weight" : [ { "id" : "45021bf73a244312a3f2af95092feeecno07", "weight" : 50 }, { "id" : "d78a65690cea4af5ad14585e110ff89bno07", "weight" : 400 } ]}