Creates an access control list (ACL) in a specified region.
Operation description
The CreateAcl operation is asynchronous. After you invoke this operation, the system returns an instance ID, but the access control policy group is not immediately created because the creation node is still running in the background. You can invoke ListAcls to query the creation status of the access control policy group:
If the access control policy group is in the Creating state, the access control policy group is being created.
If the access control policy group is in the Available state, the access control policy group is created.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
alb:CreateAcl |
create |
*Acl
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| AclName |
string |
No |
The name of the ACL. The name must start with a letter, Chinese character, or digit, and can contain digits, periods (.), underscores (_), hyphens (-), and spaces. The name must be 2 to 128 characters in length. |
test-acl |
| ClientToken |
string |
No |
The client token that is used to ensure the idempotence of the request. You can generate the parameter value on your client to ensure that the value is unique across different requests. The client token 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 perform a dry run on the request. Valid values:
|
true |
| ResourceGroupId |
string |
No |
The ID of the resource group. |
rg-atstuj3rtop**** |
| Tag |
array<object> |
No |
The tags. |
rg-12313 |
|
object |
No |
The tag structure. |
||
| Key |
string |
No |
The tag key. The tag key can be up to 128 characters in length. It cannot start with aliyun or acs:, and cannot contain http:// or https://. |
env |
| Value |
string |
No |
The tag value. The tag value can be up to 128 characters in length. It cannot start with aliyun or acs:, and cannot contain http:// or https://. |
product |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The access control list. |
||
| AclId |
string |
The ACL instance ID. |
acl-hp34s2h0xx1ht4nwo**** |
| JobId |
string |
The ID of the asynchronous task. |
72dcd26b-f12d-4c27-b3af-18f6aed5**** |
| RequestId |
string |
The ID of the request. |
CEF72CEB-54B6-4AE8-B225-F876****** |
Examples
Success response
JSON format
{
"AclId": "acl-hp34s2h0xx1ht4nwo****",
"JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
"RequestId": "CEF72CEB-54B6-4AE8-B225-F876******"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | QuotaExceeded.AclsNum | The quota of %s is exceeded, usage %s/%s. | The quota of %s is exceeded, usage %s/%s. |
| 400 | NotExist.ResourceGroup | ResourceGroup does not exist. | The resource group does not exist. |
| 403 | Forbidden.Acl | ACL authentication has failed. | Authentication failed for the ACL. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.