ModifyNatFirewallControlPolicyPosition - 更新 NAT 边界防火墙访问控制策略优先级--云防火墙-火山引擎

文档中心

导航

ModifyNatFirewallControlPolicyPosition - 更新 NAT 边界防火墙访问控制策略优先级

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

如果您需要调整访问控制策略的优先级，可调用此接口，通过实例 ID 、策略控制方向和策略 ID 更新。您可以直接将目标策略修改为指定数字对应的优先级。

注意事项

修改策略优先级前，请先调用DescribeNatFirewallControlPolicyPriorityUsed - 查询NAT边界防火墙访问控制策略优先级，获取实例下访问控制策略的优先级列表，确保优先级列表完整且连续。例如，当前共有 3 条策略，分别对应优先级 1、2、3。您在修改优先级时只能设置对应数值为 1、2 或 3。

请求说明

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

调试

API Explorer

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

去调试

请求参数

Query

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

Body

参数	类型	是否必选	示例值	描述
Direction	String	是	`in`	策略方向： in：入向 out：出向
NatFirewallId	String	是	`nfw-********`	NAT 边界防火墙实例 ID。获取方式可参考DescribeNatFirewallList - 查询NAT边界防火墙实例列表。
NewPrio	Integer	是	`1`	新优先级。说明更新前请先确认已有优先级，避免冲突。
RuleId	String	是	`f04ac7ce-**---**********`	访问控制策略唯一标识 ID。获取方式可参考DescribeNatFirewallControlPolicy - 查询 NAT 边界防火墙访问控制策略列表。

返回参数

参数	类型	示例值	描述
RuleId	String	`f04ac7ce-**---**********`	修改成功后返回访问控制策略唯一标识 ID。

请求示例

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

返回示例

{
    "ResponseMetadata": {
        "Action": "ModifyNatFirewallControlPolicyPosition",
        "Region": "cn-beijing",
        "Service": "fw_center",
        "Version": "2021-09-06",
        "RequestId": "20230604110420****100232280022D31"
    }
}

错误码

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