CreateNatFirewall-创建NAT防火墙--云防火墙-火山引擎

文档中心

立即注册

导航

CreateNatFirewall-创建NAT防火墙

最近更新时间：2025.08.11 12:01:35首次发布时间：2025.08.11 12:01:35

创建 NAT 防火墙实例。

请求说明

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

调试

API Explorer

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

去调试

请求参数

Query

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

Body

参数	类型	是否必选	示例值	描述
Bandwidth	Integer	是	`10`	NAT 边界防火墙实例的授权流量带宽，单位为 `Mbps`，表示该防火墙实例允许的最大网络带宽。
CloudFirewallId	String	否	`CloudFirewall123456`	云防火墙实例 ID，用于标识和管理云防火墙实例。
FirewallCidr	String	是	`192.168.1.0/24`	NAT 边界防火墙的子网网段，用于指定防火墙保护的网络范围，采用 CIDR 格式表示。
NatFirewallName	String	是	`nat-firewall-example`	NAT 边界防火墙实例的名称，用于标识和管理防火墙实例。
NatGatewayId	String	是	`ngw-1234567890abcdef`	NAT 网关实例 ID，用于标识和管理 NAT 网关实例。创建 NAT 防火墙时需要指定关联的 NAT 网关。
ProjectName	String	否	`project-example`	项目名称，用于标识和管理资源所属的项目。默认值为 `default`。
Tags	Array of TagStructure	否	`-`	标签信息是您在资源管理中提前配置的 KV 键值对，您可以使用资源标签从不同维度对云资源进行分类和聚合管理，并且用于标签制授权和标签分账等场景。单次最多支持绑定 20 个标签作，单个实例最多支持绑定 50 个标签。您可以调用GetTags-查询标签键值对查询标签键值对信息。

TagStructure

参数	类型	是否必选	示例值	描述
Key	String	是	`key`	根据标签键查询接口获取标签键信息并传入目标值。
Value	String	否	`value`	根据标签键查询接口获取标签键对应的标签值信息并传入目标值。

返回参数

参数	类型	示例值	描述
AccountId	String	`210005****`	创建 NAT 防火墙的账号 ID，用于标识防火墙所属的账号。
NatFirewallId	String	`nfw-12345`	NAT 边界防火墙实例的唯一标识符。

请求示例

POST https://fw-center.volcengineapi.com/?Action=CreateNatFirewall&Version=2021-09-06
{
    "Bandwidth": 10,
    "FirewallCidr": "192.168.1.0/24",
    "NatFirewallName": "nat-firewall-example",
    "NatGatewayId": "ngw-1234567890abcdef"
}

返回示例

{
    "ResponseMetadata": {
        "Action": "CreateNatFirewall",
        "Region": "cn-beijing",
        "Service": "fw_center",
        "Version": "2021-09-06",
        "RequestId": "20230604110420****100232280022D31"
    },
    "Result": {
        "AccountId": "210005****",
        "NatFirewallId": "nfw-xxxxx"
    }
}

错误码

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