调用 CreateAcl 接口，创建一个访问控制策略组。 ## 使用说明一个账号下每个地域最多可创建200个策略组。 ## 调试 ## 请求参数 |**名称** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |CreateAcl |要执行的操作，取值为CreateAcl。 | |Version |String |是 |2020\-04\-01 |API版本信息，当前版本为：2020\-04\-01。 | |AclName |String |否 |myacl |访问控制策略组的名字。|\ | | | | ||\ | | | | |* 必须以字母、数字或中文开头，可包含字母、数字、中文及以下特殊字符：点号（.）、下划线（_）和中划线（\-）。|\ | | | | |* 长度限制为1～128个字符。|\ | | | | |* 不填默认为访问控制策略组ID。 | |Description |String |否 |This is an acl. |访问控制策略组的描述。|\ | | | | ||\ | | | | |* 必须以字母、数字或中文开头，可包含字母、数字、中文及以下特殊字符：英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、中划线（\-）、中文逗号（，）、中文句号（。）。|\ | | | | |* 长度限制为0～255个字符。|\ | | | | |* 不填则默认为空字符串。 | |ProjectName |String |否 |default |访问控制策略组所属项目的名称。不填默认为default。 | |Tags.N.Key |String |否 |Tags.1.Key=key1&Tags.2.Key=key2 |用户标签的标签键。|\ | | | | ||\ | | | | |* 参数 \- N：表示标签键的序号，取值范围：1～20。|\ | | | | |* 多个标签键之间用&分隔。|\ | | | | |* 不能以 `volc:`或`sys:`开头，包括任意大小写形式。|\ | | | | |* 长度取值范围为1~128字符，允许输入各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（\-）和@（@）。|\ | | | | |* 若标签键开头或结尾存在空格，系统会自动为其去除。|\ | | | | ||\ | | | | |:::tip|\ | | | | |同一资源的标签键不允许重复。|\ | | | | ||\ | | | | |:::| |Tags.N.Value |String |否 |Tags.1.Value=value1&Tags.2.Value=value2 |用户标签的标签值。|\ | | | | ||\ | | | | |* 参数 \- N：表示标签值的序号，取值范围：1～20。|\ | | | | |* 多个标签值之间用&分隔。|\ | | | | |* 长度取值范围为0～256字符，不填默认为空。|\ | | | | |* 允许输入各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（\-）和@（@）。|\ | | | | |* 大小写敏感。|\ | | | | |* 若标签值开头或结尾存在空格，系统会自动为其去除。|\ | | | | ||\ | | | | |:::tip|\ | | | | |若传入该参数，则必须先传入`Tags.N.Key`。|\ | | | | ||\ | | | | |:::| ## 返回参数 |名称 |类型 |示例值 |描述 | |---|---|---|---| |RequestId |String |20210811152539010225146063030\*\*\*\* |请求ID。 | |AclId |String |acl\-3cj44nv0jhhxc6c6rrtet\*\*\*\* |访问控制策略组ID。 | ## 请求示例 ```json GET /?Action=CreateAcl&Version=2020-04-01&AclName=test&Description=default HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing Service: clb ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "20210811152539010225146063030****", "Action": "CreateAcl", "Version": "2020-04-01", "Service": "clb", "Region": "cn-beijing" }, "Result": { "RequestId": "20210811152539010225146063030****", "AclId": "acl-3cj44nv0jhhxc6c6rrtet****" } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6406/71761)文档。 |

HttpCode

|错误码 |错误信息 |描述 |\ |---|---|---|---| | | | | | |

400

400

400

400

400

400

400

400

400

400

|QuotaExceed.AclNumber |You've reached the limit on the number of ACL that you can create. |已达到可创建 ACL 的数量的配额上限{_tag_}。 |\ | | | | | |

403

403

404

409

负载均衡