描述
该接口用于修改允许访问实例的IP名单。接口调用必须满足以下条件,否则将失败:
请求参数
[tr=rgb(51, 205, 229)][td]名称
类型 | 是否必须 | 描述 |
Action | String | 是 | 系统规定参数,取值为ModifySecurityIps。 |
DBInstanceId | String | 是 | 实例名。 |
SecurityIps | String | 否 | IP白名单分组下的IP列表,最多1000个以逗号隔开,格式如下:
- 0.0.0.0/0,10.23.12.24(IP);
- 10.23.12.24/24(CIDR模式,无类域间路由,/24表示了地址中前缀的长度,范围[1,32])。
|
DBInstanceIPArrayName | String | 否 | IP白名单分组的名字,如果不传默认操作“Default”分组。备注:1个实例最多支持50个白名单分组。 |
DBInstanceIPArrayAttribute | String | 否 | 默认为空。用于区分不同的属性值,控制台不显示带有“hidden”标签的分组。 |
ModifyMode | String | 否 | 修改方式,取值如下:
- Cover:默认值,覆盖原白名单。
- Append:追加白名单
- Delete:删除该白名单
|
返回参数
[tr=rgb(51, 205, 229)][td]名称
类型 | 描述 |
RequestId | String | 详见公共参数。 |
TaskId | String | 任务ID。 |
请求示例
https:
//rds.aliyuncs.com/?Action=ModifySecurityIps
&DBInstanceId=rdsaiiabnaiiabn
&SecurityIps=192.168.1.2
&<公共请求参数>
返回示例
XML格式
<ModifySecurityIpsResponse>
<RequestId>65BDA532-28AF-4122-AA39-B382721EEE64
</RequestId>
</ModifySecurityIpsResponse>
JSON格式
{"RequestId":
" 65BDA532-28AF-4122-AA39-B382721EEE64"}
阿里云 AI 助理回答
要修改允许访问实例的IP白名单,您需要通过调用ModifySecurityIps
接口来完成此操作。在进行接口调用时,请确保您的实例状态为运行中且未被锁定。以下是调用该接口所需关注的请求参数及说明:
-
Action:
- 类型: String
- 是否必须: 是
- 描述: 系统规定参数,固定取值为
ModifySecurityIps
。
-
DBInstanceId:
- 类型: String
- 是否必须: 是
- 描述: 实例ID,标识要修改白名单的具体数据库实例。
-
SecurityIps:
- 类型: String
- 是否必须: 否
- 描述: IP白名单分组下的IP列表,最多支持1000个条目,以逗号分隔。支持IP地址(如:10.23.12.24)和CIDR格式(如:10.23.12.24/24),其中CIDR模式中的前缀长度范围为1到32。
-
DBInstanceIPArrayName:
- 类型: String
- 是否必须: 否
- 描述: 需要修改的IP白名单分组名称,默认操作“Default”分组。一个实例最多可支持50个白名单分组。
-
DBInstanceIPArrayAttribute:
- 类型: String
- 是否必须: 否
- 描述: 默认为空字符串。用于区分不同的属性值,带有"hidden"标签的分组不会在控制台显示。
-
ModifyMode:
- 类型: String
- 是否必须: 否
- 描述: 修改方式,可选值包括:
Cover
(默认值):覆盖原白名单。
Append
:追加白名单,若有重复则报错。
Delete
:删除指定的白名单。
返回参数 包括: - RequestId: 用于标识请求的唯一ID。 - TaskId: 任务ID,可用于查询任务执行状态。
请求示例:
https://rds.aliyuncs.com/?Action=ModifySecurityIps
请根据实际需求设置相应的参数值,并确保您已具备调用此接口所需的权限。在执行操作前,建议先在OpenAPI Explorer中调试,以验证配置并获取SDK代码示例,这将帮助您更安全、便捷地完成IP白名单的修改。