You can call this operation to create an access control list (ACL).
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | No | CreateACL |
The operation that you want to perform. Set the value to CreateACL. |
Name | String | Yes | test |
The name of the ACL to be created. The name must be 2 to 128 characters in length and can contain digits, periods (.),
underscores (_), and hyphens (-). It must start with a letter or Chinese character
but cannot start with |
RegionId | String | Yes | cn-hangzhou |
The ID of the region to which the ACL belongs. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | EE837E9F-BD50-4C2B-9E47-260F9D848480 |
The ID of the request. |
AclId | String | acl-xhwhyuo43l******** |
The ID of the ACL. |
Examples
Sample requests
http(s)://[Endpoint]/? Action=CreateACL
&Name=test
&RegionId=cn-hangzhou
&<Common request parameter>
Sample success responses
XML
format
<CreateACL>
<AclId>acl-xhwhyuo43l********</AclId>
<RequestId>EE837E9F-BD50-4C2B-9E47-260F9D848480</RequestId>
</CreateACL>
JSON
format
{
"AclId": "acl-xhwhyuo43l********",
"RequestId": "EE837E9F-BD50-4C2B-9E47-260F9D848480"
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
403 | Forbidden | User not authorized to operate on the specified resource. | The error code returned because you do not have the permission to manage the resource. |
403 | MissingParameter | The input parameter is missing, please check your input. | The error code returned because a request parameter is not set. Check the request parameters. |
403 | InvalidName | Name not valid. | The error code returned because the name of the ACL is invalid. |
403 | AclAmountLimit | No more ACL can be created. You can open a ticket to increase the quota of ACLs. | The error code returned because you have reached the upper limit of the ACL quota. Submit a ticket to increase the ACL quota. |
403 | InternalError | An internal server error occurred. | The error code returned because an internal server error occurred. |
For a list of error codes, visit the API Error Center.