API 名称：RemoveAclEntries。
API 域名：open.volcengineapi.com。
API 描述：为指定访问控制策略组删除 IP 条目。调用一次接口删除 IP 条目上限为50个。
节流限制：每秒最多提交 5 个 API 请求。
在使用该部分 API 提交请求时必须包含以下 URI 参数。
除了 URI 参数，该 API 请求还需要包含签名参数。关于更多签名参数的信息，参见公共请求参数。
| 名称 | 类型 | 是否必选 | 格式 | 说明 |
|---|---|---|---|---|
| Action | string | 是 | [a-zA-Z]+ | API 名称，如 RemoveAclEntries 。 |
| Version | string | 是 | YYYY-MM-DD | API 版本信息。该参数的取值是 2020-04-01 。 |
| X-Expires | int | 否 | 900 | 表示签名的有效时间，单位是秒，默认值是900。 |
在使用该 API 提交请求时，请求参数中可以包含的参数如下。
| 参数 | 类型 | 是否必选 | 参数说明 | 示例值 |
|---|---|---|---|---|
| AclId | String | 是 | 访问控制策略组ID 。 | acl-3cj44nv0jhhxc6c6rrtet**** |
Entries.N | List of String | 是 | IP条目的地址段。
| Entries.1=192.XX.XX.7/16& Entries.2=172.XX.XX.0/24 |
| 参数 | 类型 | 参数说明 | 示例值 |
|---|---|---|---|
| RequestId | String | 20210811152539010225146063030**** | 请求ID。 |
GET /?Action=RemoveAclEntries&AclId=acl-33txelibucdfk57uhwmviq46o&Entries.1=1.0.0.0/8&Version=2020-04-01 HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing ServiceName: alb
{ "ResponseMetadata": { "RequestId": "2021081618465****225142142010A77B9", "Action": "RemoveAclEntries", "Version": "2020-04-01", "Service": "alb", "Region": "cn-beijing" }, "Result": { "RequestId": "202108161846****0225142142010A77B9" } }
如果响应正文包含 Error 字段，则表示 API 请求失败。此处仅展示当前 API 的错误码，更多错误码请参见公共错误码。
| HTTP Code | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
400 | LimitExceed.AclEntry | You've reached the limit on the number of ACL entries that you can operate at a time. | 已达到单次可操作的 IP 条目的数量上限。 |
400 | InvalidAclEntries.Entry.Duplicated | The specified AclEntries.Entry is duplicated. | 指定的 AclEntries.Entry 重复。 |
| 400 | InvalidIndexOrder.Malformed | The specified index order is malformed. | 指定的索引顺序参数格式不合法。 |
400 | InvalidAcl.InvalidStatus | The specified ACL is not in the correct status for the request. | 指定的 ACL 所处状态无法响应该请求。 |
| 404 | InvalidAcl.NotFound | The specified ACL does not exist. | 指定的 ACL 不存在。 |
| 404 | InvalidAclEntry.NotFound | The specified AclEntry does not exist. | 指定的 IP 条目不存在。 |