Creates an access control list (ACL).
Debug
Use OpenAPI Explorer to perform debug operations and generate SDK code examples.
Request parameters
| Parameter | Type | Required? | Example value | Description |
|---|---|---|---|---|
| Name | String | Yes | test |
The name of the ACL. The name must be 2 to 128 characters in length and can contain letters, numbers, periods
(.), underscores (_), and hyphens (-). The name must start with a letter or a Chinese
character. It cannot start with |
| RegionId | String | Yes | cn-hangzhou |
The ID of the region. |
| Action | String | No | CreateACL |
The name of this action. Value: CreateACL. |
Response parameters
| Parameter | Type | Example value | Description |
|---|---|---|---|
| AclId | String | acl-xhwhyuo43l******** |
The ID of the ACL. |
| RequestId | String | EE837E9F-BD50-4C2B-9E47-260F9D848480 |
The ID of the request. |
Examples
Request example
http(s)://[Endpoint]/? Name=test
&RegionId=cn-hangzhou
&<CommonParameters>
Response example
XML format
<CreateACL>
<AclId>acl-ohlexqptfhygf4xebg</AclId>
<RequestId>EE837E9F-BD50-4C2B-9E47-260F9D848480</RequestId>
</CreateACL>
JSON format
{
"AclId":"acl-ohlexqptfhyg******",
"RequestId":"EE837E9F-BD50-4C2B-9E47-260F9D848480"
}Errors
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 403 | Forbidden | User not authorized to operate on the specified resource. | You are not authorized to use the specified resource. |
| 403 | MissingParameter | The input parameter is missing, please check your input. | The required parameter is missing. |
| 403 | InvalidName | Name not valid. | The specified name is invalid. |
| 403 | AclAmountLimit | No more ACL can be created. You can open a ticket to increase the quota of ACLs. | The number of ACLs has reached the quota. You can open a ticket to increase the quota. |
| 403 | InternalError | An internal server error occurred. | An internal server error has occurred. |