🌟 本文档由麒曦Chish 整理发布，与官方无关，不代表官方立场，仅供参考，请以官方发布为准。

排队创建防火墙规则

设计中

POST

/hosts/firewall/rules

最后修改时间：2026-09-21 04:51:37

责任人：麒曦

Creation and import return a taskID immediately; validation and execution results are written to the task log.

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "items": [
        {
            "rule": {
                "action": "accept",
                "connectionStates": [
                    "string"
                ],
                "description": "string",
                "destinationAddress": "string",
                "destinationPort": "string",
                "interface": "string",
                "nativeKind": "rule",
                "orderBucket": "string",
                "orderIndex": 0,
                "priority": 0,
                "protocol": "string",
                "scope": {
                    "chain": "string",
                    "direction": "input",
                    "family": "string",
                    "provider": "string",
                    "table": "string",
                    "zone": "string"
                },
                "sourceAddress": "string",
                "sourcePort": "string",
                "uuid": "string"
            },
            "sourceID": "string",
            "sourceKind": "user"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/hosts/firewall/rules' \
--header '1Panel-Token: {{Token}}' \
--header '1Panel-Timestamp: {{UnixTimestamp}}' \
--header 'Content-Type: application/json' \
--data '{
    "items": [
        {
            "rule": {
                "action": "accept",
                "connectionStates": [
                    "string"
                ],
                "description": "string",
                "destinationAddress": "string",
                "destinationPort": "string",
                "interface": "string",
                "nativeKind": "rule",
                "orderBucket": "string",
                "orderIndex": 0,
                "priority": 0,
                "protocol": "string",
                "scope": {
                    "chain": "string",
                    "direction": "input",
                    "family": "string",
                    "provider": "string",
                    "table": "string",
                    "zone": "string"
                },
                "sourceAddress": "string",
                "sourcePort": "string",
                "uuid": "string"
            },
            "sourceID": "string",
            "sourceKind": "user"
        }
    ]
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "errors": [
        {
            "error": "string",
            "index": 0,
            "rule": {
                "action": "accept",
                "connectionStates": [
                    "string"
                ],
                "description": "string",
                "destinationAddress": "string",
                "destinationPort": "string",
                "interface": "string",
                "nativeKind": "rule",
                "orderBucket": "string",
                "orderIndex": 0,
                "priority": 0,
                "protocol": "string",
                "scope": {
                    "chain": "string",
                    "direction": "input",
                    "family": "string",
                    "provider": "string",
                    "table": "string",
                    "zone": "string"
                },
                "sourceAddress": "string",
                "sourcePort": "string",
                "uuid": "string"
            },
            "status": "string"
        }
    ],
    "failed": 0,
    "queued": true,
    "skipped": 0,
    "succeeded": 0,
    "taskID": "string"
}

🟠400请求有误

🟠409

修改于 2026-09-21 04:51:37

操作防火墙

接管外部防火墙规则