更新白名单
更新时间：2026-01-09
接口说明
白名单需要全量更新，每次更新需要把全部白名单列表都添加上。
当前v1版本接口仅可操作 default 白名单分组，其余自定义的白名单分组信息无法通过v1版本接口操作。如有需求请使用v2版本接口。
请求URI
Plain Text
1PUT /v{version}/instance/{instanceId}/securityIp
2Host: rds.bj.baidubce.com
3Authorization: authorization string
4{
5 "securityIps" : [ "xx.xx.xx.xx","xx.xx.xx.xx" ]
6}请求头域
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 描述 |
|---|---|---|---|---|
| x-bce-if-match | String | 是 | v1 | 通过查询接口获取到的ETag值，仅在 version 取值为1时需要设置此信息，version 为2时，无需设置此信息 |
请求参数
| 参数名称 | 参数类型 | 是否必须 | 参数位置 | 示例值 | 描述 |
|---|---|---|---|---|---|
| version | Integer | 是 | URL参数 | 1 | API 版本号，当前支持取值1、2。取值为1时，仅可操作默认的白名单分组（default）信息；取值为2时，支持操作指定白名单分组信息，操作类型包括创建、更新、删除白名单分组相关信息 |
| instanceId | String | 是 | URL参数 | rds-ZuZd7s1l | 实例 ID |
| action | String | 否 | Query参数 | update | 操作类型，当 version 取值为2时，必填。取值有三种，分别为：update（更新指定的白名单分组信息）、create（创建指定的白名单分组信息）、delete（删除指定的白名单分组信息） |
| securityIps | List<String> | 是 | RequestBody参数 | ["127.0.0.1", "192.168.1.2"] | 白名单IP列表 |
| tag | String | 否 | RequestBody参数 | test_group_name | 指定的白名单分组名称，当 version 取值为2时，必填 |
返回头域
除公共头域外，无其它特殊头域。
返回参数
无
v1版本示例
请求示例
Plain Text
1PUT /v1/instance/rds-ZuZd7s1l/securityIp
2Host: rds.bj.baidubce.com
3Content-Type: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5x-bce-if-match: v1
6{
7 "securityIps" : [ "127.0.0.1" ]
8}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/jsonv2版本示例
请求示例
Plain Text
1PUT /v2/instance/rds-ZuZd7s1l/securityIp?action=update
2Host: rds.bj.baidubce.com
3Content-Type: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5{
6 "tag": "test1",
7 "securityIps": [
8 "192.168.1.5"
9 ]
10}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json