You need to enable JavaScript to run this app.
文档中心
负载均衡

负载均衡

复制全文
下载 pdf
访问控制
AddAclEntries - 添加访问控制策略条目
复制全文
下载 pdf
AddAclEntries - 添加访问控制策略条目
调用 AddAclEntries 接口,为指定访问控制策略组添加IP条目。​
使用说明​
每个访问控制策略组中最多可添加300个IP条目。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
Action String 必选 示例值:AddAclEntries​
要执行的操作,取值:AddAclEntries。​
​
Version String 必选 示例值:2020-04-01​
API的版本信息,当前版本为 2020-04-01。​
​
AclId String 必选 示例值:acl-3cj44nv0jhhxc6c6rrtet****​
访问控制策略组的ID。您可以调用DescribeAcls接口获取访问控制策略组ID。​
​
AclEntries.N.Entry String 必选 示例值:192.168.1.7/32​
IP条目的地址段,只支持CIDR地址。​
  • 参数 - N:表示IP条目的序号,取值范围:1 ~ 50。​
  • 支持同时传入IPv4和IPv6条目。​
  • 多个IP条目间使用&分隔。​
  • IP地址/地址段不能为0.0.0.0、0.0.0.0/x或::/x。​
  • IP地址段应为标准格式,IP和掩码要对应,例如192.168.0.0/16,若输入192.168.1.0/16则不正确。​
说明​
  • 如果监听器所属CLB实例为IPv4类型,那么访问控制策略组关联到监听器后,已添加IPv6条目不生效。​
  • 双栈负载均衡的功能正在邀测中,暂仅支持完成企业认证的账号申请试用,如需试用,请联系客户经理。​
​
AclEntries.N.Description String 可选 示例值:entry1​
IP条目的描述,默认值为空字符串。​
  • 参数 - N:表示IP条目的序号,取值范围:1 ~ 50。​
  • 多个IP条目间使用&分隔。​
  • 规范如下:​
  • 必须以字母、数字或中文开头,可包含字母、数字、中文及以下特殊字符:英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、中划线(-)、中文逗号(,)、中文句号(。)。​
  • 长度限制为0 ~ 255个字符。​
​
​
​
返回参数​
RequestId String 示例值:20210811152539010225146063030****​
请求ID​
​
​
​
请求示例​
​
GET /?Action=AddAclEntries&Version=2020-04-01&AclId=acl-3cj44nv0jhhxc6c6rrtet****&AclEntries.1.Entry=192.168.1.7/32&AclEntries.1.Description=entry1​
Host: clb.cn-beijing.volcengineapi.com​
X-Date: 20251121T094038Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/clb/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420****100232280022D31",​
"Action": "AddAclEntries",​
"Version": "2020-04-01",​
"Service": "clb",​
"Region": "cn-beijing"​
},​
"Result": {​
"RequestId": "20210811152539010225146063030****"​
}​
}​
​
错误码​
此处仅展示当前API的错误码,更多错误码请参见公共错误码。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidAcl.InvalidStatus​
The specified ACL is not in the correct status for the request.​
指定的 ACL 所处状态无法响应该请求。​
400​
InvalidCIDR.Malformed​
The specified CIDR is malformed.​
指定的 CIDR 参数格式不合法。​
400​
InvalidDescription.Malformed​
The specified Description is malformed.​
指定的 Description 参数格式不合法。​
400​
InvalidIncorrectOrder.Malformed​
The specified index order is malformed.​
指定的索引顺序参数格式不合法。​
400​
LimitExceeded.IPOperation​
You've reached the limit on the number of IP that you can operate at a time.​
已达到单次可操作的 IP 条目数量上限。​
400​
LimitExceeded.IPTotal​
You've reached the limit on the total number of IP that you can create in an ACL.​
已达到可添加 IP 的数量上限。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'AclId'.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 AclId。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the ''.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'AclEntries'.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 AclEntries。​
403​
InvalidResourceType.ServcieManaged​
The specified ResourceType is managed by a service.​
指定的资源是服务托管资源。​
404​
InvalidAcl.NotFound​
The specified ACL does not exist.​
指定的 ACL 不存在。​
409​
InvalidEntry.Conflict​
The specified ACL Entry already exits.​
指定 ACL 的 IP 条目已存在。​
500​
InternalError​
An internal error has occurred.​
发生内部错误。​
​
​
最近更新时间:2026.02.13 10:32:59
这个页面对您有帮助吗?
有用
有用
无用
无用