参数管理接口说明
更新时间：2025-08-22
获取参数列表
返回该实例下数据库参数列表。
请求结构
Plain Text
1GET /v{version}/instance/{instanceId}/parameter HTTP/1.1
2HOST: rds.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | string | 是 | URL参数 | API 版本号 |
| instanceId | string | 是 | URL参数 | 实例ID |
返回头域
| 参数名称 | 类型 | 描述 |
|---|---|---|
| ETag | string | 当前版本号，在修改的时候需要把当前ETag通过header的方式传递回去 |
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| parameters | List parameter | 由[Parameter](RDS/API参考/对象说明.md#Parameter Object详情)组成的数组 |
请求示例
Plain Text
1GET /v{version}/instance/{instanceId}/parameter HTTP/1.1
2HOST: rds.bj.baidubce.com
3Authorization: bce-auth-v1/rdsak/2016-07-03T06:13:13Z/1800/x-bce-date/{signature}返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
3ETag:xxx-xxx-xxx
4Content-Type: application/json
5Content-Length: 567
6
7{
8 "parameters": [
9 {
10 "name" : "wait_timeout",
11 "defaultValue" : "28800",
12 "value" : "1",
13 "pendingValue" : "",
14 "type" : "integer",
15 "dynamic" : true,
16 "modifiable" : true,
17 "allowedValues" : "60-86400",
18 "desc" : "服务器等待非交互连接的超时时间。"
19 },
20 {
21 "name" : "lower_case_table_names",
22 "defaultValue" : "1",
23 "value" : "1",
24 "pendingValue" : "2",
25 "type" : "string",
26 "dynamic" : false,
27 "modifiable" : true,
28 "allowedValues" : "0,1,2",
29 "desc" : "表名区分大小写的模式。"
30 },
31 {
32 "name" : "sql_mode",
33 "defaultValue" : "",
34 "value" : "",
35 "pendingValue" : "",
36 "type" : "set<string>",
37 "dynamic" : true,
38 "modifiable" : true,
39 "allowedValues" : "ALLOW_INVALID_DATES, ANSI_QUOTES, ERROR_FOR_DIVISION_BY_ZERO, HIGH_NOT_PRECEDENCE, IGNORE_SPACE, NO_AUTO_CREATE_USER, NO_AUTO_VALUE_ON_ZERO, NO_BACKSLASH_ESCAPES, NO_DIR_IN_CREATE, NO_ENGINE_SUBSTITUTION, NO_FIELD_OPTIONS, NO_KEY_OPTIONS, NO_TABLE_OPTIONS, NO_UNSIGNED_SUBTRACTION, NO_ZERO_DATE, NO_ZERO_IN_DATE, ONLY_FULL_GROUP_BY, PAD_CHAR_TO_FULL_LENGTH, PIPES_AS_CONCAT, REAL_AS_FLOAT, STRICT_ALL_TABLES, STRICT_TRANS_TABLES",
40 "desc" : "SQL语法和校验的模式。"
41 }
42 ]
43}修改配置参数
说明
修改云数据库 RDS for MySQL 的参数配置。
请求结构
Plain Text
1PUT /v{version}/instance/{instanceId}/parameter HTTP/1.1
2HOST: rds.bj.baidubce.com
3x-bce-if-match: {ETag}
4Authorization: authorization string
5
6{
7 "parameters" : parameters
8}请求头域
| 参数名称 | 类型 | 描述 |
|---|---|---|
| x-bce-if-match | string | 通过查询接口获取到的ETag值 |
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | string | 是 | URL参数 | API 版本号 |
| instanceId | string | 是 | URL参数 | 实例ID |
| parameters | List parameter | 是 | RequestBody参数 | 需要修改的参数列表 |
Parameter结构
| 参数名称 | 类型 | 描述 |
|---|---|---|
| name | string | 参数名 |
| value | string | 参数取值 |
返回头域
除公共头域，无其它特殊头域。
返回参数
无特殊返回参数。
请求示例
Plain Text
1GET /v{version}/instance/{instanceId}/parameter HTTP/1.1
2HOST: rds.bj.baidubce.com
3x-bce-if-match: V11
4Authorization: bce-auth-v1/rdsak/2016-07-03T06:13:13Z/1800/x-bce-date/{signature}
5
6{
7 "parameters" : [
8 {
9 "name" : "lower_case_table_names",
10 "value": "2"
11 },
12 {
13 "name" : "wait_timeout",
14 "value": "86400"
15 },
16 {
17 "name" : "sql_mode",
18 "value": "ALLOW_INVALID_DATES,ANSI_QUOTES,REAL_AS_FLOAT"
19 }
20 ]
21}返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
3Content-Type: application/json
4Content-Length: 0