Adds IP entries to an access control policy group.
Operation description
-
Each policy group can contain multiple IP address entries or CIDR block entries. The entry limits for an access control policy group are as follows:
Maximum number of IP address entries that can be added per account per call: 20.
Maximum number of entries that each access control policy group can contain: 500.
-
The AddEntriesToAcl operation is asynchronous. After you call this operation, the system returns a request ID, but the IP entries are not immediately added to the access control policy group. The addition task is still running in the background. You can call ListAclEntries to query the addition status of the IP entries:
If the access control policy group is in the Adding state, the IP entries are being added.
If the access control policy group is in the Available state, the IP entries are added.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
alb:AddEntriesToAcl |
create |
*Acl
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| AclId |
string |
Yes |
The ACL instance ID. |
acl-hp34s2h0xx1ht4nwo**** |
| AclEntries |
array<object> |
Yes |
The list of access control entries to be added. You can add up to 20 access control entries in a single call. |
|
|
object |
No |
The access control policy structure. |
||
| Description |
string |
No |
The description of the access control entry. The description must be 2 to 256 characters in length, and can contain letters, digits, Chinese characters, commas (,), periods (.), semicolons (;), forward slashes (/), at signs (@), underscores (_), and hyphens (-). You can add up to 20 access control entries in a single call. |
test-entry |
| Entry |
string |
Yes |
The CIDR block of the access control entry. |
10.0.1.0/24 |
| ClientToken |
string |
No |
The client token that is used to ensure the idempotence of the request. You can generate the parameter value from your client and make sure that the value is unique across different requests. The ClientToken parameter supports only ASCII characters. Note
If you do not specify this parameter, the system automatically uses the RequestId of the API request as the ClientToken. The RequestId of each API request is unique. |
5A2CFF0E-5718-45B5-9D4D-70B3****** |
| DryRun |
boolean |
No |
Specifies whether to only precheck the request. Valid values:
|
false |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Adds IP entries to an access control policy group. |
||
| JobId |
string |
The ID of the asynchronous task. |
72dcd26b-f12d-4c27-b3af-18f6aed5**** |
| RequestId |
string |
The ID of the request. |
365F4154-92F6-4AE4-92F8-7FF34****** |
Examples
Success response
JSON format
{
"JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
"RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | ResourceAlreadyExist.AclEntry | The specified resource %s already exists. | The IP entry already exists in the access control policy group. |
| 400 | ResourceQuotaExceeded.AclEntriesNum | The quota of %s is exceeded for resource %s, usage %s/%s. | The quota %s has been exceeded. The resource is %s. The current usage is %s. The quota is %s. |
| 400 | IncorrectStatus.Acl | The status of %s [%s] is incorrect. | The current status of the access control policy group ACL does not support this operation. |
| 400 | ResourceQuotaExceeded.ListenerAclEntriesNum | The quota of %s is exceeded for resource %s, usage %s/%s. | The quota of %s is exceeded for resource %s, usage %s/%s. |
| 400 | ResourceQuotaExceeded.LoadBalancerAclEntriesNum | The quota of %s is exceeded for resource %s, usage %s/%s. | The quota of %s is exceeded for resource %s, usage %s/%s. |
| 404 | ResourceNotFound.Acl | The specified resource %s is not found. | The access control policy group ACL does not exist. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.