DescribeNatFirewallControlPolicyPriorityUsed - 查询 NAT 边界防火墙访问控制策略优先级--云防火墙-火山引擎

文档中心

立即注册

导航

DescribeNatFirewallControlPolicyPriorityUsed - 查询 NAT 边界防火墙访问控制策略优先级

最近更新时间：2025.05.29 17:45:46首次发布时间：2024.11.24 23:48:55

每条访问控制策略都有生效优先级。您可以调用此接口，根据 NAT 边界防火墙访问控制策略方向和实例 ID，查询实例当前已使用的优先级信息，以便随时按需调整优先级。

使用说明

该接口可返回实例下入向或出向的策略优先级起始值和结束值。例如返回的优先级起始值为 1，结束值为 3，表明当前实例下该方向共有 3 条访问控制策略，优先级分别为 1、2、3。

请求说明

请求方式：POST
请求地址：https://fw_center.volcengineapi.com/?Action=DescribeNatFirewallControlPolicyPriorityUsed&Version=2021-09-06

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`DescribeNatFirewallControlPolicyPriorityUsed`	接口名称。当前 API 的名称为 `DescribeNatFirewallControlPolicyPriorityUsed`。
Version	String	是	`2021-09-06`	接口版本。当前 API 的版本为 `2021-09-06`。

Body

参数类型是否必选示例值描述

参数	类型	是否必选	示例值	描述
Direction	String	是	`in`	策略的方向，取值如下所示。 `in`：入向； `out`：出向。
NatFirewallId	String	是	`nfw-********`	NAT 边界防火墙实例 ID。获取方式可参考DescribeNatFirewallList - 查询NAT边界防火墙实例列表。

Direction

String

是

in

策略的方向，取值如下所示。

in：入向；
out：出向。

NatFirewallId String 是 nfw-******** NAT 边界防火墙实例 ID。获取方式可参考DescribeNatFirewallList - 查询NAT边界防火墙实例列表。

返回参数

参数	类型	示例值	描述
AccountId	String	`2100052***`	用户的唯一标识符，用于区分不同用户账户。
End	Integer	`3`	表示该防火墙实例下访问控制策略的优先级结束值。
NatFirewallId	String	`nfw-********`	NAT 边界防火墙实例的唯一标识符，用于区分不同的防火墙实例。
Start	Integer	`1`	表示该防火墙实例下访问控制策略的优先级起始值。

请求示例

POST https://fw_center.volcengineapi.com/?Action=DescribeNatFirewallControlPolicyPriorityUsed&Version=2021-09-06
{
    "Direction": "in",
    "NatFirewallId": "nfw-********"
}

返回示例

{
    "ResponseMetadata": {
        "Action": "DescribeNatFirewallControlPolicyPriorityUsed",
        "Region": "cn-beijing",
        "Service": "fw_center",
        "Version": "2021-09-06",
        "RequestId": "20230604110420****100232280022D31"
    },
    "Result": {
        "AccountId": "2100052***",
        "End": 3,
        "NatFirewallId": "nfw-********",
        "Start": 1
    }
}

错误码

您可访问公共错误码，获取更多错误码信息。