文档首页/ 虚拟私有云 VPC/ API参考/ 历史API/ API（OpenStack Neutron V2.0 原生）（废弃）/ 网络ACL（废弃）/ 创建网络ACL规则
更新时间：2025-01-07 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建网络ACL规则

功能介绍

创建网络ACL规则。

调试

您可以在API Explorer中调试该接口。

URI

POST /v2.0/fwaas/firewall_rules

请求参数

表1 请求参数

参数名称

是否必选

类型

说明

firewall_rule

是

firewall_rule object

firewall rule对象。请参见表2。
表2 Firewall Rule对象

属性

是否必选

类型

约束

说明

name

否

String

最长255个字符

网络ACL规则名称。

使用说明：最长255个字符

description

否

String

最长255个字符

网络ACL规则描述。

使用说明：最长255个字符

protocol

否

String

支持TCP，UDP，ICMP， ICMPV6

IP协议。

取值范围：支持TCP，UDP，ICMP， ICMPV6

source_port

否

String

位于[1,65535]中一个整数或者一段端口范围a:b

源端口号或者一段端口范围。

取值范围：位于[1,65535]中一个整数或者一段端口范围a:b

destination_port

否

String

位于[1,65535]中一个整数或者一段端口范围a:b

目的端口号或者一段端口范围。

取值范围：位于[1,65535]中一个整数或者一段端口范围a:b

ip_version

否

Integer

4/6

IP协议版本。

取值范围：4、6，分别表示创建ipv4和ipv6。

source_ip_address

否

String

N/A

源地址或者CIDR。

destination_ip_address

否

String

N/A

目的地址或者CIDR。

action

否

String

deny/allow

对通过网络ACL的流量执行的操作。

取值范围：deny（拒绝）/allow（允许）

enabled

否

Boolean

true/false

是否使能网络ACL规则。

取值范围：true/false

请求示例

创建ACL规则，action为allow，IP协议为tcp，目的端口为80。

POST https://{Endpoint}/v2.0/fwaas/firewall_rules

{
    "firewall_rule": {
        "action": "allow", 
        "enabled": true, 
        "destination_port": "80", 
        "protocol": "tcp", 
        "name": "ALLOW_HTTP"
    }
}

响应参数

表3 响应参数

参数名称

类型

说明

firewall_rule

firewall_rule object

firewall rule对象。请参见表4。
表4 Firewall Rule对象

属性

类型

说明

id

String

网络ACL规则的uuid标识。

name

String

网络ACL规则名称。

description

String

网络ACL规则描述。

tenant_id

String

项目ID

public

Boolean

是否支持跨租户共享。

protocol

String

IP协议。

source_port

String

源端口号或者一段端口范围。

destination_port

String

目的端口号或者一段端口范围。

ip_version

Integer

IP协议版本。

source_ip_address

String

源地址或者CIDR。

destination_ip_address

String

目的地址或者CIDR。

action

String

对通过网络ACL的流量执行的操作。

enabled

Boolean

是否使能网络ACL规则。

project_id

String

项目ID，请参见获取项目ID。

响应示例

{
    "firewall_rule": {
        "protocol": "tcp", 
        "description": "", 
        "source_ip_address": null, 
        "destination_ip_address": null, 
        "source_port": null, 
        "destination_port": "80", 
        "id": "b94acf06-efc2-485d-ba67-a61acf2a7e28", 
        "name": "ALLOW_HTTP", 
        "tenant_id": "23c8a121505047b6869edf39f3062712", 
        "enabled": true, 
        "action": "allow", 
        "ip_version": 4, 
        "public": false,
        "project_id": "23c8a121505047b6869edf39f3062712"
    }
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 网络ACL（废弃）

相关文档