文档中心

云数据库 PostgreSQL 版

数据安全

ModifyAllowList

ModifyAllowList

调用 ModifyAllowList 接口修改白名单。

请求类型

同步请求。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

请求参数

参数	类型	是否必选	示例值	描述
AllowListId	String	是	acl-2b7d64502b0a4210a24c58e739de****	白名单的 ID。可调用 DescribeAllowLists 接口查询。
AllowListName	String	是	新的白名单名称	可与原白名单名字相同，也可以不相同。不相同时，会以 AllowListName 字段的值为白名单重新命名。白名单名称的命名规则如下：在当前地域内，白名单名称唯一。以中文、字母或下划线（_）开头。只能包含中文、字母、数字、下划线（_）和中划线（-）。长度为 1~128 个字符。
AllowListDesc	String	否	这是一段新的白名单描述信息。	白名单的描述信息。长度在 200 字符以内。说明无默认值。不设定该参数时则不修改原有描述信息。
AllowList	String	否	10.1.1.1,10.2.3.0/24	白名单中包含的 IP 地址。多个 IP 地址间以英文逗号（,）分隔。IP 地址不可重复。支持以下两种格式： IP 地址格式。例如：10.23.12.24。 CIDR 的 IP 地址段格式。例如：10.23.12.0/24（无类别域间路由，24 表示了地址中前缀的长度，范围为 1~32）。说明每个白名单最多可添加 300 个 IP 或 IP 地址段，当 IP 较多时，建议合并为IP段填入，例如10.23.12.0/24。禁止将 0.0.0.0/0 之外的形如 x.x.x.x/0 的 IP 地址加入白名单。无默认值。不设定该参数时则不修改白名单原有的 IP。
ModifyMode	String	否	Cover	修改白名单的方式。取值： Cover：覆盖，即使用 AllowList 字段的值覆盖原白名单。默认值。 Append：追加，即在原白名单中增加 AllowList 字段包含的 IP 地址。 Delete：删除，即在原白名单中删除 AllowList 字段包含的 IP 地址。至少需要保留一个 IP 地址。注意如需修改的白名单绑定有安全组，或需要在修改白名单时为白名单绑定安全组，则 ModifyMode 只能取值为 Cover。
ApplyInstanceNum	Integer	否	1	绑定了该白名单的实例数量，用于确认本次修改的影响范围，避免误操作。说明无默认值。不传值时则表示不对修改该白名单所涉及的实例数量进行确认。
AllowListCategory	String	否	Default	白名单分类。取值： Ordinary：普通白名单。 Default：默认白名单。说明该参数作为请求参数时无默认值，不传入时则查询所有类别的白名单。
SecurityGroupBindInfos	Array of SecurityGroupBindInfo	否	请参见请求示例。	为白名单绑定的安全组的信息。
UpdateSecurityGroup	Boolean	否	true	是否更新白名单所绑定的安全组。取值： true：更新。 false：不更新。默认值。
UserAllowList	String	否	10.1.1.1,10.2.3.0/24	安全组之外的、需要加入白名单的 IP 地址。可输入 IP 地址或 CIDR 格式的 IP 地址段。

SecurityGroupBindInfo

参数	类型	是否必选	示例值	描述
IpList	Array of String	否	["10...1/32","10...2/32"]	安全组中的 IP。
BindMode	String	是	IngressDirectionIp	关联安全组的模式。取值： IngressDirectionIp：入方向 IP。 AssociateEcsIp：关联 ECSIP。
SecurityGroupId	String	是	sg-b8pzuwk3i4g028j06k8f****	安全组 ID。
SecurityGroupName	String	否	测试安全组	安全组名称。

返回参数

null

示例

请求示例

返回示例

最近更新时间：2026.03.31 10:39:11

这个页面对您有帮助吗？

有用

有用

无用

无用