创建aclrules

POST

/v4/acl-rule/create

创建aclrules：支持批量创建
1.15版本支持新返回格式
如果批量有成功也有失败的，返回当前acl下所有的acl规则id
如果创建都不成功，则返回空对象

请求参数

Body 参数application/json

regionID

string

资源池ID

必需

aclID

string

ACL ID

必需

rules

array [object {11}]

rule 规则数组

必需

protocol

string

必需

all, icmp, tcp, udp, gre, icmp6

sourceIpAddress

string

源地址

必需

sourcePort

string

可选

开始和结束port以:隔开（UDP和TCP协议时，端口号必填）

destinationIpAddress

string

目的地址

必需

destinationPort

string

可选

开始和结束port以:隔开（UDP和TCP协议时，端口号必填）

priority

integer

优先级

必需

ipVersion

string

必需

ipv4, ipv6

direction

string

必需

类型,ingress, egress

description

string

描述

可选

enabled

string

可选

disable, enable

action

string

必需

accept, drop

示例

{
    "regionID": "TestRegionID",
    "aclID": "acl-hamyeruox0",
    "rules": [
        {
            "protocol": "tcp",
            "sourceIpAddress": "0.0.0.0/2",
            "sourcePort": "55:66",
            "destinationIpAddress": "0.0.0.0/3",
            "destinationPort": "77:88",
            "priority": 4,
            "ipVersion": "ipv4",
            "direction": "ingress",
            "description": "test",
            "enabled": "disable",
            "action": "accept"
        },
        {
            "protocol": "tcp",
            "sourceIpAddress": "0.0.0.0/2",
            "sourcePort": "55:66",
            "destinationIpAddress": "0.0.0.0/3",
            "destinationPort": "77:88",
            "priority": 5,
            "ipVersion": "ipv4",
            "direction": "ingress",
            "description": "test",
            "enabled": "disable",
            "action": "accept"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v4/acl-rule/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "TestRegionID",
    "aclID": "acl-hamyeruox0",
    "rules": [
        {
            "protocol": "tcp",
            "sourceIpAddress": "0.0.0.0/2",
            "sourcePort": "55:66",
            "destinationIpAddress": "0.0.0.0/3",
            "destinationPort": "77:88",
            "priority": 4,
            "ipVersion": "ipv4",
            "direction": "ingress",
            "description": "test",
            "enabled": "disable",
            "action": "accept"
        },
        {
            "protocol": "tcp",
            "sourceIpAddress": "0.0.0.0/2",
            "sourcePort": "55:66",
            "destinationIpAddress": "0.0.0.0/3",
            "destinationPort": "77:88",
            "priority": 5,
            "ipVersion": "ipv4",
            "direction": "ingress",
            "description": "test",
            "enabled": "disable",
            "action": "accept"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

description

string

失败时的错误描述

必需

errorCode

string

具体错误码标志

必需

message

string

失败时的错误信息

必需

returnObj

object

返回参数

必需

aclID

string

aclID

必需

aclRuleIDs

array[string]

必需

acl规则id
1.15新增对齐字段

statusCode

integer <int32>

必需

返回状态码(800为成功，900为失败)

示例

{
    "description": "成功 X-Trace-ID-->6936cb954dd1a713",
    "errorCode": "SUCCESS",
    "message": "success",
    "returnObj": {
        "aclID": "acl-hamyeruox0",
        "aclRuleIDs": [
            "aclrule-2a7d9yf9zc",
            "aclrule-6f5sq807a9",
            "aclrule-0hl36lek04",
            "aclrule-xi5nxuo28x",
            "aclrule-4nrumxq1r8",
            "aclrule-3lk9vduuq8",
            "aclrule-5dh8k5wgbk",
            "aclrule-3rv25rwl6p"
        ]
    },
    "statusCode": 800
}

修改于 2024-05-13 10:08:43

创建acl

删除acl