更新时间:2022-01-25 GMT+08:00

创建网络ACL规则

功能介绍

创建网络ACL规则。

URI

POST /v2.0/fwaas/firewall_rules

请求消息

表1 请求参数

参数名称

是否必选

类型

说明

firewall_rule

Object

firewall rule对象。请参见表2

表2 Firewall Rule对象

属性

是否必选

类型

约束

说明

name

String

最长255个字符

网络ACL规则名称。

使用说明:最长255个字符

description

String

最长255个字符

网络ACL规则描述。

使用说明:最长255个字符

protocol

String

支持TCP,UDP,ICMP, 或者0-255

IP协议。

取值范围:支持TCP,UDP,ICMP, 或者0-255

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

IPv4/IPv6

IP协议版本。

取值范围: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

响应消息

表3 响应参数

参数名称

类型

说明

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

样例

请求样例

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

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

响应样例

{
    "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"
    }
}

状态码

请参见状态码

错误码

请参见错误码