调用ModifyDBClusterAccessWhitelist接口创建或修改PolarDB集群的白名单（包括IP白名单和安全组）。

调试

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

请求参数

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

系统规定参数，取值为ModifyDBClusterAccessWhitelist。

DBClusterId String 是 pc-*************

集群ID。
WhiteListType String 否 IP

白名单类型。取值范围如下：

  • IP：IP白名单分组。
  • SecurityGroup：安全组。

默认值为IP。

DBClusterIPArrayName String 否 default

IP白名单分组的名称。分组名称长度需为2~120个字符；由小写字母和数字组成；以字母开头，以字母或数字结尾。

  • 如果传入的白名单分组名称不存在，则会创建该白名单分组。
  • 如果传入的白名单分组名称已存在，则会修改该白名单分组。
  • 不传入则修改default分组。
说明
  • 1个集群最多支持50个IP白名单分组。
  • 当WhiteListType取值为IP时该参数才支持配置。
DBClusterIPArrayAttribute String 否 hidden

IP白名单分组属性。设置为hidden后控制台不可见。

说明
  • 已在控制台显示的IP白名单分组不支持隐藏。
  • 当WhiteListType取值为IP时该参数才支持配置。
SecurityIps String 否 10.23.12.24

IP白名单分组中的IP地址或地址段。所有IP白名单分组累积支持1000个IP地址或地址段，多个IP间用英文逗号（,）隔开，支持如下两种格式：

  • IP地址形式，例如：10.23.12.24。
  • CIDR形式，例如：10.23.12.24/24（无类域间路由，24表示地址中前缀的长度，长度范围为1~32）。
说明 当WhiteListType取值为IP时该参数才支持配置。
ModifyMode String 否 Cover

IP白名单的修改方式，取值范围如下：

  • Cover：覆盖原IP白名单（默认值）。
  • Append：追加IP。
  • Delete：删除IP。
说明 当WhiteListType取值为IP时该参数才支持配置。
SecurityGroupIds String 否 sg-*********

安全组ID，多个安全组间用英文逗号（,）隔开。

说明
  • 1个集群最多支持3个安全组。
  • 当WhiteListType取值为SecurityGroup时该参数才支持配置。

返回数据

名称 类型 示例值 描述
RequestId String D0CEC6AC-7760-409A-A0D5-E6CD86******

请求ID。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=ModifyDBClusterAccessWhitelist
&DBClusterId=pc-*************
&<公共请求参数>

正常返回示例

XML 格式 

<ModifyDBClusterAccessWhitelistResponse>  
      <RequestId>D0CEC6AC-7760-409A-A0D5-E6CD86******</RequestId>
</ModifyDBClusterAccessWhitelistResponse>

JSON 格式 

{
  "RequestId": "D0CEC6AC-7760-409A-A0D5-E6CD86******"
}

错误码

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