调用ModifySecurityIps接口修改白名单。

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

调试

前往【API Explorer】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。

请求参数

名称 类型 是否必选 示例值 描述
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”分组。

说明 单个实例最多支持50个白名单分组。
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

SecurityGroupId String rg-acfmyxxxxx

安全组编码。

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
}

错误码

查看本产品错误码