调用ModifySecurityIps接口修改RDS实例IP白名单。

添加IP地址到IP白名单内，允许这些IP地址访问该RDS实例。详情请参见设置白名单。

说明 调用该接口时，实例状态必须为运行中，否则将操作失败。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ModifySecurityIps

系统规定参数，取值：ModifySecurityIps。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

实例ID。
SecurityIps String 是 10.23.12.24

该实例的IP白名单，多个IP地址请以英文逗号（,）隔开，不可重复，最多1000个。支持如下两种格式：

  • IP地址形式，例如：10.23.12.24。
  • CIDR形式，例如：10.23.12.24/24（无类域间路由，24表示了地址中前缀的长度，范围为1~32）。
DBInstanceIPArrayName String 否 test

需要修改的IP白名单分组名称，默认操作“Default”分组。

说明 单个实例最多支持200个白名单分组。
DBInstanceIPArrayAttribute String 否 hidden

白名单分组属性，默认为空。

说明 控制台不显示带有“hidden”属性的分组，带有该标签的分组通常是用于访问DTS、DRDS服务的。
ModifyMode String 否 Cover

修改方式，取值：

  • Cover：覆盖原IP白名单；
  • Append：追加IP；
  • Delete：删除IP。

默认值：Cover。

WhitelistNetworkType String 否 Classic

白名单的网络类型，取值：

  • Classic：高安全白名单模式下的经典网络；
  • VPC：高安全白名单模式下的专有网络；
  • MIX：通用模式，在通用白名单模式下会添加IP到通用分组里，在高安全白名单模式下会同时添加IP到经典网络和专有网络分组里。

默认值：MIX。

SecurityIPType String 否 IPv4

IP地址类型。

返回数据

名称 类型 示例值 描述
RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

请求ID。
TaskId String 115855279

任务ID。

示例

请求示例


http(s)://rds.aliyuncs.com/?Action=ModifySecurityIps
&DBInstanceId=rm-uf6wjk5xxxxxxx
&SecurityIps=10.23.12.24
&<公共请求参数>

正常返回示例

XML 格式 

<ModifySecurityIpsResponse>
	  <RequestId> 1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>
	  <TaskId>115855279</TaskId>
</ModifySecurityIpsResponse>

JSON 格式 

{
	"RequestId":" 1AD222E9-E606-4A42-BF6D-8A4442913CEF",
	"TaskId":115855279
}

错误码

访问错误中心查看更多错误码。