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

列出统一防火墙 v2 规则

设计中

POST

/hosts/firewall/rules/search

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

责任人：麒曦

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "actions": [
        "accept"
    ],
    "all": true,
    "excludeChains": [
        "1PANEL_BASIC_BEFORE"
    ],
    "families": [
        "ipv4"
    ],
    "info": "string",
    "page": 0,
    "pageSize": 0,
    "scope": {
        "chain": "string",
        "direction": "input",
        "family": "string",
        "provider": "string",
        "table": "string",
        "zone": "string"
    },
    "scopes": [
        {
            "chain": "string",
            "direction": "input",
            "family": "string",
            "provider": "string",
            "table": "string",
            "zone": "string"
        }
    ],
    "states": [
        "managed"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/hosts/firewall/rules/search' \
--header '1Panel-Token: {{Token}}' \
--header '1Panel-Timestamp: {{UnixTimestamp}}' \
--header 'Content-Type: application/json' \
--data '{
    "actions": [
        "accept"
    ],
    "all": true,
    "excludeChains": [
        "1PANEL_BASIC_BEFORE"
    ],
    "families": [
        "ipv4"
    ],
    "info": "string",
    "page": 0,
    "pageSize": 0,
    "scope": {
        "chain": "string",
        "direction": "input",
        "family": "string",
        "provider": "string",
        "table": "string",
        "zone": "string"
    },
    "scopes": [
        {
            "chain": "string",
            "direction": "input",
            "family": "string",
            "provider": "string",
            "table": "string",
            "zone": "string"
        }
    ],
    "states": [
        "managed"
    ]
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "allTotal": 0,
    "items": [
        {
            "desired": {
                "marker": "string",
                "observedInstanceKey": "string",
                "origin": "string",
                "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"
                },
                "ruleKey": "string",
                "uuid": "string"
            },
            "match": "none",
            "observed": {
                "instanceKey": "string",
                "locator": {
                    "canonical": "string",
                    "nativeId": "string",
                    "position": 0,
                    "provider": "string",
                    "scopeKey": "string"
                },
                "marker": "string",
                "parseStatus": "supported",
                "persistence": "converged",
                "protected": true,
                "raw": "string",
                "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"
                }
            },
            "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"
            },
            "state": "managed",
            "usage": {
                "reason": "string",
                "used": true,
                "usedBy": [
                    "string"
                ]
            }
        }
    ],
    "managedTotal": 0,
    "notices": [
        {
            "code": "default_scope_mismatch",
            "values": [
                "string"
            ]
        }
    ],
    "total": 0
}

🟠400请求有误

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

调整受管统一防火墙 v2 规则顺序

更新受管统一防火墙 v2 规则