接口功能介绍
创建ACL规则
接口约束
无
URI
POST /v3/aclRule/create
路径参数
无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池ID。 | d8bbd132b53a11e9b0e40242ac110002 |
请求参数
请求头header参数
无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| aclOid | 是 | String | 被添加规则所属ACL ID | acl-ixpc4edyti2kx9c1q7dvy | |
| direction | 是 | String | 方向（ingress-入方向;egress-出方向） | ingress | |
| ruleList | 是 | Array of Objects | 规则列表，单次长度限制[1,20]，源/目的地址处于同一子网下的网络ACL规则不生效 | ruleList | |
| aclRuleOid | 否 | String | ACL规则ID，相对位置是before或after时必填 | ||
| relativePosition | 否 | String | 所添加规则的相对位置（default-添加到最后，优先级最低;before-向前添加，优先级更高;after-向后添加，优先级更低），默认值为default |
表 ruleList
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| name | 是 | String | ACL规则名称，只能包含英文字母、数字、下划线、中划线，长度限制1-16个字符 | 222 | |
| type | 是 | String | 类型（ipv4-IPv4;ipv6-IPv6） | ipv6 | |
| strategy | 是 | String | 策略（allow-允许；deny-拒绝） | deny | |
| protocol | 是 | String | 协议（tcp-TCP协议;udp-UDP协议;all-全部协议;icmpv4-ICMPv4协议;icmpv6-ICMPv6协议） | tcp | |
| sourceAddress | 否 | String | 此方向允许的源地址。当前支持形式：IP地址段。type为ipv4时，默认值为0.0.0.0/0；type为ipv6时，默认值为::/0，代表支持所有的IP地址 | null | |
| destinationAddress | 否 | String | 此方向允许的目的地址。当前支持形式：IP地址段。type为ipv4时，默认值为0.0.0.0/0；type为ipv6时，默认值为::/0，代表支持所有的IP地址 | null | |
| sourcePort | 否 | String | 源端口范围，选择TCP或UDP协议时必须填写，取值范围是1-65535的数字。 表示单个端口时，指定端口号。 表示某一范围时，两个数字以:分隔（例如，1:100）；若为空，则表示全部端口（1-65535） |
null | |
| destinationPort | 否 | String | 目的端口范围，选择TCP或UDP协议时必须填写，取值范围是1-65535的数字。 表示单个端口时，指定端口号。 表示某一范围时，两个数字以:分隔（例如，1:100）；若为空，则表示全部端口（1-65535） |
null | |
| description | 是 | String | 描述，字符数限制[0,100] | decs-zYUV7w6E |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 状态码。可能值： - 800：请求成功。 - 900：请求失败。 |
800 | |
| error | String | 错误码。 | ||
| message | String | 提示信息。 | OK. | |
| returnObj | Object | 返回数据结构体。 | { } | returnObj |
枚举参数
无
请求示例
请求url
无
请求头header
无
请求体body
{"aclOid":"acl-xxx","direction":"ingress","ruleList":[{"name":"name-6E9588UA","type":"ipv6","strategy":"deny","protocol":"tcp","sourceAddress":null,"destinationAddress":null,"sourcePort":null,"destinationPort":null,"description":"decs-zYUV7w6E"}]}
响应示例
{"statusCode":800,"message":"OK.","returnObj":{ }}
状态码
请参考 状态码
错误码
请参考 错误码
