To manage network traffic within a specific region of a
Virtual Private Cloud (VPC) network, configure regional network firewall
policies and rules. This page describes how to create a
regional network firewall policy, associate it with a specific
VPC network and region, and then define rules. These rules
control ingress and egress traffic for virtual machine (VM) instances and
internal load balancers.

Before you read this page, ensure you are familiar with the concepts described
in the
[Regional network firewall policies](https://docs.cloud.google.com/firewall/docs/regional-firewall-policies.md.txt).

## Create a regional network firewall policy

When you create a regional network firewall policy using the Google Cloud console, you
can associate the policy with a region and VPC network during
creation. If you create the policy using the Google Cloud CLI, you must [associate
the policy with a region and network](https://docs.cloud.google.com/firewall/docs/use-regional-firewall-policies#associate) after you create the policy.

The VPC network with which the regional network firewall policy is
associated must be in the same project as the regional network firewall policy.

#### Permissions required for this task

To perform this task, you must have been granted the following permissions
*or* one of the following IAM roles.

**Permissions**

- `compute.regionFirewallPolicies.create`

**Roles**

- Compute Security Admin (`roles/compute.securityAdmin`) on the project where you want to create the policy

### Console

1. In the Google Cloud console, go to the **Firewall policies** page.

   [Go to Firewall policies](https://console.cloud.google.com/net-security/firewall-manager/firewall-policies/list)
2. In the project selector menu, select your project
   within your organization.

3. Click **Create firewall policy**.

4. In the **Policy name** field, enter a policy name.

5. For **Policy type** , select **VPC policy** or **RDMA RoCE policy**.

   > [!NOTE]
   > **Note:** The RDMA RoCE is only supported for regional network firewall policy. When you select the RoCE policy type, the deployment scope is automatically set to regional and can't be modified.

6. For **Deployment scope** , select **Regional**. Select the region
   where you want to create this firewall policy.

7. To create rules for your policy, click **Continue**.

8. In the **Add rules** section, click **Create firewall rule**. For more
   information about creating firewall rules, see the following:

   - [Create an ingress rule for VM
     targets](https://docs.cloud.google.com/firewall/docs/use-regional-firewall-policies#create-ingress-rule-target-vm)
   - [Create an ingress rule for internal Application Load Balancer and internal proxy Network Load Balancer
     targets](https://docs.cloud.google.com/firewall/docs/use-regional-firewall-policies#create-ingress-rule-target-lb)
   - [Create an egress rule for VM targets](https://docs.cloud.google.com/firewall/docs/use-regional-firewall-policies.md.txt#create-egress-rule-target-vm)
9. If you want to associate the policy with a network, click
   **Continue**.

10. In the **Associate policy with networks** section, click
    **Associate**.

    For more information, see [Associate a policy with a network](https://docs.cloud.google.com/firewall/docs/use-regional-firewall-policies.md.txt#associate).
11. Click **Create**.

### gcloud

```
gcloud compute network-firewall-policies create \
    NETWORK_FIREWALL_POLICY_NAME \
    --description DESCRIPTION \
    --policy-type POLICY_TYPE \
    --region=REGION_NAME
```

Replace the following:

- `NETWORK_FIREWALL_POLICY_NAME`: a name for the policy
- `DESCRIPTION`: a description for the policy
- `POLICY_TYPE`: type of network firewall policy. For more information, see [Specifications](https://docs.cloud.google.com/firewall/docs/regional-firewall-policies.md.txt#specifications).
- `REGION_NAME`: the region for the policy

## Associate a policy with a network

You can associate a regional network firewall policy with a region of a
VPC network and apply the rules in the policy to
that network region.

#### Permissions required for this task

To perform this task, you must have been granted the following permissions
*or* one of the following IAM roles.

**Permissions**

- `compute.regionFirewallPolicies.use`
- `compute.networks.setFirewallPolicy`

**Roles**

- Compute Network Admin (`roles/compute.networkAdmin`) on the firewall policy or project containing the firewall policy *or*
- Compute Security Admin (`roles/compute.securityAdmin`) on the firewall policy or project containing the firewall policy

### Console

1. In the Google Cloud console, go to the **Firewall policies** page.

   [Go to Firewall policies](https://console.cloud.google.com/net-security/firewall-manager/firewall-policies/list)
2. In the project selector menu, select your project that contains
   your policy.

3. Click your policy.

4. Click the **Associations** tab.

5. Click **Add association**.

6. Select the networks within the project.

7. Click **Associate**.

### gcloud

```
gcloud compute network-firewall-policies associations create \
    --firewall-policy POLICY_NAME \
    --firewall-policy-region=POLICY_REGION \
    --network NETWORK_NAME \
    --name ASSOCIATION_NAME
```

Replace the following:

- `POLICY_NAME`: the short name or the system-generated name of the policy.
- `POLICY_REGION`: the region of the policy that contains the rule.
- `NETWORK_NAME`: the name of the associated network.
- `ASSOCIATION_NAME`: an optional name for the association. If unspecified, the name is set to `network-NETWORK_NAME`.

## Add rules in a regional network firewall policy

This section describes how to add rules in a regional network firewall policy.

### Create an ingress rule for VM targets

#### Permissions required for this task

To perform this task, you must have been granted the following permissions
*or* one of the following IAM roles.

**Permissions**

- `compute.regionFirewallPolicies.update`

**Roles**

- Compute Security Admin (`roles/compute.securityAdmin`) on the firewall policy or project containing the firewall policy


This section describes how to create an [ingress
rule](https://docs.cloud.google.com/firewall/docs/firewall-policies-overview#ingress_rules) that applies
to network interfaces of Compute Engine instances.

<br />

### Console


1. In the Google Cloud console, go to the **Firewall policies** page.

   [Go to Firewall policies](https://console.cloud.google.com/net-security/firewall-manager/firewall-policies/list)
2. In the project selector list, select a project that contains a
   regional network firewall policy.

3. In the **Network firewall policies** section, click the name of a
   regional network firewall policy in which you want to create a rule.

4. In the **Firewall rules** section, click **Create firewall rule** and
   specify the following configuration parameters:

   1. **Priority**: the numeric evaluation order of the rule.

      The rules are evaluated from highest to lowest priority where `0`
      is the highest priority. Priorities must be unique for each rule.
      We recommend that you separate rule priority values by more than
      just a difference of one (for example, `100`, `200`, `300`) so
      that you can create new rules between the existing rules later.
   2. **Description**: provide an optional description.

   3.


      **Target type** : select **Instances**.

      When you select this option, Cloud NGFW uses VM instances as the
      target.

   4.

      **Target**: select one of the following:
      - **Apply to all** : Cloud NGFW uses the [broadest instance
        targets](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#target-vm-broadest).
      - **Service accounts** : narrows the broadest instance targets to the network interfaces of VM instances that use the service account you specify:

        <br />

        - In the **Service account scope** section, select **In this
          project \> Target service account**. This is to specify a service account in the same project as the regional network firewall policy.
        - In the **Service account scope** section, select **In another
          project \> Target service account**. This is to specify a service account in a Shared VPC service project.
      - **Secure tags** : narrows the broadest instance targets to the network interfaces of VM instances that are bound to at least one of the [secure
        tag](https://docs.cloud.google.com/firewall/docs/tags-firewalls-overview) values that you specify. Click **Select scope for tags** and select the organization or project that contains the tag values to match. To add more tag values, click **Add tag**.

      <br />

   5. **Direction of traffic** : select **Ingress**.

   6.
      **Action on match**: select one of the following:

      - **Allow**: to permit connections that match the rule parameters.
      - **Deny**: to block connections that match the rule parameters.
      - **Go to next** : to continue the [firewall rule evaluation
        process](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-eval-order#default-rule-evaluation).

      <br />

   7. **Logs** : select **Enabled** to enable firewall rules logging or
      **Disabled** to disable firewall rules logging for this rule.

   8.
      **Source network context** : specify a
      [network context](https://docs.cloud.google.com/firewall/docs/understand-network-contexts.md.txt):

      - To skip filtering inbound traffic by network context, select **All network contexts**.
      - To filter inbound traffic to a specific network context, select **Specific network context** , and then select a network context:
        - **Internet** : inbound traffic must match the [Internet
          network context for ingress
          packets](https://docs.cloud.google.com/firewall/docs/understand-network-contexts#internet-context-ingress).
        - **Non-internet** : inbound traffic must match the [Non-internet network context for ingress
          packets](https://docs.cloud.google.com/firewall/docs/understand-network-contexts#non-internet-ingress).
        - **Intra VPC** : inbound traffic must match the [Criteria for intra-VPC
          network context](https://docs.cloud.google.com/firewall/docs/understand-network-contexts#intra-vpc-network-context-criteria).
        - **VPC networks** : inbound traffic must match the [Criteria for VPC networks
          context](https://docs.cloud.google.com/firewall/docs/understand-network-contexts#vpc-networks-context-criteria). You must select at least one VPC network:
          - **Select current project**: lets you add one or more VPC network from the project that contains the firewall policy.
          - **Manually enter network**: lets you manually enter a project and VPC network.
          - **Select project**: lets you select a project from which you can select a VPC network.

      <br />

   9.
      **Source filters** : specify additional source parameters. Some source
      parameters can't be used together, and your choice of source
      network context limits which source parameters you can use. For
      more information, see [Sources for ingress
      rules](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-ingress-src)
      and [Ingress rule source
      combinations](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-ingress-src-combinations).

      - To filter inbound traffic by source IPv4 ranges, select **IPv4** , and then enter the CIDR blocks in the **IP ranges** field. Use `0.0.0.0/0` for any IPv4 source.
      - To filter inbound traffic by source IPv6 ranges, select **IPv6** , and then enter the CIDR blocks into the **IPv6 ranges** field. Use `::/0` for any IPv6 source.
      - To filter inbound traffic by source secure tag values, select **Select scope for tags** in the **Secure tags** section. Then, provide tag keys and tag values. To add more tag values, click **Add tag**.
      - To filter inbound traffic by source FQDN, enter FQDNs in the **FQDNs** field. For more information, see [FQDN
        objects](https://docs.cloud.google.com/firewall/docs/fqdn-objects-overview).
      - To filter inbound traffic by source geolocation, select one or more locations from the **Geolocations** field. For more information, see [Geolocation
        objects](https://docs.cloud.google.com/firewall/docs/geolocation-objects-overview).
      - To filter inbound traffic by source address group, select one or more address groups from the **Address groups** field. For more information, see [Address groups for firewall
        policies](https://docs.cloud.google.com/firewall/docs/address-groups-firewall-policies).
      - To filter inbound traffic by source Google Threat Intelligence lists, select one or more Google Threat Intelligence lists from the **Google Cloud
        Threat Intelligence** field. For more information, see [Google Threat Intelligence for firewall policy rules](https://docs.cloud.google.com/firewall/docs/threat-intelligence-overview.md.txt).

      <br />

   10.
       **Destination** : specify optional destination parameters. For more
       information, see [Destinations for ingress
       rules](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-ingress-dest).

       - To skip filtering inbound traffic by destination IP address, select **None**.
       - To filter inbound traffic to by destination IP address, select **IPv4** or **IPv6** and then enter one or more CIDRs using the same format used for source IPv4 ranges or source IPv6 ranges.

       <br />

   11. **Protocols and ports** : specify the protocols and destination ports
       for traffic to match the rule. For more information, see [Protocols
       and
       ports](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#protocols_and_ports).

   12. **Enforcement**: specify whether the firewall rule is enforced or
       not:

       - **Enabled**: creates the rule and begins enforcing the rule on new connections.
       - **Disabled**: creates the rule but doesn't enforce the rule on new connections.
5. Click **Create**.

<br />

### gcloud


```
gcloud compute network-firewall-policies rules create PRIORITY \
    --firewall-policy=POLICY_NAME \
    --project=PROJECT_ID \
    --firewall-policy-region=POLICY_REGION \
    --description=DESCRIPTION \
    --direction=INGRESS \
    --action=ACTION \
    [--enable-logging | --no-enable-logging] \
    [--disabled | --no-disabled] \
    [--target-secure-tags=TARGET_SECURE_TAGS] \
    [--target-service-accounts=TARGET_SERVICE_ACCOUNTS] \
    [--layer4-configs=LAYER_4_CONFIGS] \
    [--src-network-context=SRC_NETWORK_CONTEXT] \
    [--src-networks=SRC_VPC_NETWORKS] \
    [--src-ip-ranges=SRC_IP_RANGES] \
    [--src-address-groups=SRC_ADDRESS_GROUPS] \
    [--src-fqdns=SRC_DOMAIN_NAMES] \
    [--src-secure-tags=SRC_SECURE_TAGS] \
    [--src-region-codes=SRC_COUNTRY_CODES] \
    [--src-threat-intelligence=SRC_THREAT_LIST_NAMES] \
    [--dest-ip-ranges=DEST_IP_RANGES]
```

Replace the following:

- `PRIORITY`: the numeric evaluation order of the rule within the policy. The rules are evaluated from highest to lowest priority, where `0` is the highest priority. Priorities must be unique for each rule. We recommend that you separate rule priority values by more than just a difference of one (for example, `100`, `200`, `300`) so that you can create new rules between the existing rules later.
- `POLICY_NAME`: the name of the regional network firewall policy in which you want to create the rule.
- `PROJECT_ID`: the project ID that contains the regional network firewall policy.
- `POLICY_REGION`: the region of the policy.
- `DESCRIPTION`: an optional description for the new rule.
- `ACTION`: specify one of the following actions:

  <br />

  - `allow`: allows connections that match the rule.
  - `deny`: denies connections that match the rule.
  - `goto_next`: continues the [firewall rule evaluation
    process](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-eval-order#default-rule-evaluation).
- The `--enable-logging` and `--no-enable-logging` flags enable or disable VPC firewall rules logging.
- The `--disabled` and `--no-disabled` flags control whether the rule is disabled (not enforced) or enabled (enforced).
- Specify a [target](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details.md.txt#targets):

  <br />

  - If you omit both the `--target-secure-tags` and `--target-service-accounts` flags, Cloud NGFW uses the [broadest instance
    targets](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#target-vm-broadest).
  - `TARGET_SECURE_TAGS`: a comma-separated list of [secure
    tag](https://docs.cloud.google.com/firewall/docs/tags-firewalls-overview) values that narrows the broadest instance targets to the network interfaces of VM instances that are bound to at least one of the secure tag values.
  - `TARGET_SERVICE_ACCOUNTS`: a comma-separated list of service accounts that narrows the broadest instance targets to the network interfaces of VM instances that use one of the service accounts.

<!-- -->

- `LAYER_4_CONFIGS`: a comma-separated list of Layer 4
  configs. Each Layer 4 config can be one of the following:

  - An IP protocol name (`tcp`) or IANA IP protocol number (`6`) without any destination port.
  - An IP protocol name and destination port separated by a colon (`tcp:80`).
  - An IP protocol name and destination port range separated by a colon using a dash to separate the beginning and ending destination ports (`tcp:5000-6000`).

  For more information, see [Protocols and
  ports](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#protocols_and_ports).

<!-- -->

- Specify a [source for the ingress
  rule](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-ingress-src). For more information, [Ingress rule source
  combinations](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-ingress-src-combinations):

  <br />

  - `SRC_NETWORK_CONTEXT`: defines a source network contexts to be used in conjunction with another supported source parameter to produce a source combination. Valid values when `--target-type=INSTANCES` are: `INTERNET`, `NON_INTERNET`, `VPC_NETWORKS`, or `INTRA_VPC`. For more information, see [Network contexts](https://docs.cloud.google.com/firewall/docs/understand-network-contexts.md.txt).
  - `SRC_VPC_NETWORKS`: a comma-separated list of VPC networks specified by their URL identifiers. Specify this flag only when the `--src-network-context` is `VPC_NETWORKS`.
  - `SRC_IP_RANGES`: a comma-separated list of IP address ranges in CIDR format. Ranges in the list must all be either IPv4 CIDRs or IPv6 CIDRs, not a combination of both.
  - `SRC_ADDRESS_GROUPS`: a comma-separated list of address groups specified by their [unique URL
    identifiers](https://docs.cloud.google.com/firewall/docs/address-groups-firewall-policies#address-group-specification). Address groups in the list must contain all IPv4 addresses or all IPv6 addresses, not a combination of both.
  - `SRC_DOMAIN_NAMES`: a comma-separated list of FQDN objects specified in the [domain name
    format](https://docs.cloud.google.com/firewall/docs/fqdn-objects-overview#domain-name-format).
  - `SRC_SECURE_TAGS`: a comma-separated list of [Tags](https://docs.cloud.google.com/firewall/docs/tags-firewalls-overview.md.txt). You cannot use the `--src-secure-tags` flag if the `--src-network-context` is `INTERNET`.
  - `SRC_COUNTRY_CODES`: a comma-separated list of two-letter country codes. For more information, see [Geolocation
    objects](https://docs.cloud.google.com/firewall/docs/geolocation-objects-overview). You cannot use the `--src-region-codes` flag if the `--src-network-context` is `NON_INTERNET`, `VPC_NETWORKS`, or `INTRA_VPC`.
  - `SRC_THREAT_LIST_NAMES`: a comma-separated list of names of Google Threat Intelligence lists. For more information, see [Google Threat Intelligence for
    firewall policy
    rules](https://docs.cloud.google.com/firewall/docs/threat-intelligence-overview). You cannot use the `--src-threat-intelligence` flag if the `--src-network-context` is `NON_INTERNET`, `VPC_NETWORKS`, or `INTRA_VPC`.
- Optionally, specify a [destination for the ingress
  rule](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-ingress-dest):

  <br />

  - `DEST_IP_RANGES`: a comma-separated list of IP address ranges in CIDR format. Ranges in the list must all be either IPv4 CIDRs or IPv6 CIDRs, not a combination of both.

<br />

### Create an ingress rule for internal load balancer targets

To restrict access to one or more internal Application Load Balancer or internal proxy Network Load Balancer
forwarding rules, create at least two ingress rules that use internal load
balancers as targets. This is necessary because the
[implied action](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-eval-order.md.txt#default-rule-evaluation)
for internal Application Load Balancer and internal proxy Network Load Balancer targets allows ingress.
The rules needed to restrict access are:

- A lower priority ingress deny firewall rule with `--src-ip-ranges=0.0.0.0/0`.
- A higher priority ingress allow firewall rule with the source parameters you specify.

#### Permissions required for this task

To perform this task, you must have been granted the following permissions
*or* one of the following IAM roles.

**Permissions**

- `compute.regionFirewallPolicies.update`

**Roles**

- Compute Security Admin (`roles/compute.securityAdmin`) on the firewall policy or project containing the firewall policy


This section describes how to create an
[ingress rule](https://docs.cloud.google.com/firewall/docs/firewall-policies-overview.md.txt#ingress_rules)
for internal Application Load Balancers and internal proxy Network Load Balancer targets.

<br />

### Console


1. In the Google Cloud console, go to the **Firewall policies** page.

   [Go to Firewall policies](https://console.cloud.google.com/net-security/firewall-manager/firewall-policies/list)
2. In the project selector list, select a project that contains a
   regional network firewall policy.

3. In the **Network firewall policies** section, click the name of a
   regional network firewall policy in which you want to create a rule.

4. In the **Firewall rules** section, click **Create firewall rule** and
   specify the following configuration parameters:

   1. **Priority**: the numeric evaluation order of the rule.

      The rules are evaluated from highest to lowest priority where `0`
      is the highest priority. Priorities must be unique for each rule.
      We recommend that you separate rule priority values by more than
      just a difference of one (for example, `100`, `200`, `300`) so
      that you can create new rules between the existing rules later.
   2. **Description**: provide an optional description.

   3.


      **Target type** : select **Internal load balancers**.

      When you select this option, Cloud NGFW uses internal Application Load Balancers and
      internal proxy Network Load Balancers as the target.

      <br />

   4.

      **Target**: select one of the following:
      - **Apply to all** : Cloud NGFW uses the [broadest load balancer
        targets](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#target-lb-broadest).
      - **Forwarding rule** : To select the forwarding rule, do the following:
        1. Click **Select project** and select a project.
        2. For **Load balancer type**, select the load balancer type.
        3. For **Load balancer**, select the load balancer.
        4. For **Forwarding rule**, select the forwarding rule.

      <br />

   5.
      **Action on match**: select one of the following:

      - **Allow**: to permit connections that match the rule parameters.
      - **Deny**: to block connections that match the rule parameters.
      - **Go to next** : to continue the [firewall rule evaluation
        process](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-eval-order#default-rule-evaluation).

      <br />

   6. **Logs** : select **Enabled** to enable firewall rules logging or
      **Disabled** to disable firewall rules logging for this rule.

   7.
      **Source network context** : specify a
      [network context](https://docs.cloud.google.com/firewall/docs/understand-network-contexts.md.txt):

      - To skip filtering inbound traffic by network context, select **All network contexts**.
      - To filter inbound traffic to a specific network context, select **Specific network context**, and then select a network context:
      - **Intra VPC** : inbound traffic must match the [Criteria for intra-VPC
        network context](https://docs.cloud.google.com/firewall/docs/understand-network-contexts#intra-vpc-network-context-criteria).
      - **VPC networks** : inbound traffic must match the [Criteria for VPC networks
        context](https://docs.cloud.google.com/firewall/docs/understand-network-contexts#vpc-networks-context-criteria). You must select at least one VPC network:
        - **Select current project**: lets you add one or more VPC network from the project that contains the firewall policy.
        - **Manually enter network**: lets you manually enter a project and VPC network.
        - **Select project**: lets you select a project from which you can select a VPC network.
   8.
      **Source filters** : specify additional source parameters. Some source
      parameters can't be used together, and your choice of source
      network context limits which source parameters you can use. For
      more information, see [Sources for ingress
      rules](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-ingress-src)
      and [Ingress rule source
      combinations](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-ingress-src-combinations).

      - To filter inbound traffic by source IPv4 ranges, select **IPv4** , and then enter the CIDR blocks in the **IP ranges** field. Use `0.0.0.0/0` for any IPv4 source.
      - To filter inbound traffic by source IPv6 ranges, select **IPv6** , and then enter the CIDR blocks into the **IPv6 ranges** field. Use `::/0` for any IPv6 source.
      - To filter inbound traffic by source FQDN, enter FQDNs in the **FQDNs** field. For more information, see [FQDN
        objects](https://docs.cloud.google.com/firewall/docs/fqdn-objects-overview).
      - To filter inbound traffic by source address group, select one or more address groups from the **Address groups** field. For more information, see [Address groups for firewall
        policies](https://docs.cloud.google.com/firewall/docs/address-groups-firewall-policies).

      <br />

   9. **Enforcement**: specify whether the firewall rule is enforced or
      not:

      - **Enabled**: creates the rule and begins enforcing the rule on new connections.
      - **Disabled**: creates the rule but doesn't enforce the rule on new connections.
5. Click **Create**.

<br />

### gcloud


```
gcloud compute network-firewall-policies rules create PRIORITY \
    --firewall-policy=POLICY_NAME \
    --project=PROJECT_ID \
    --firewall-policy-region=POLICY_REGION \
    --description=DESCRIPTION \
    --direction=INGRESS \
    --action=ACTION \
    [--enable-logging | --no-enable-logging] \
    [--disabled | --no-disabled] \
    --target-type=INTERNAL_MANAGED_LB \
    [--target-forwarding-rules=TARGET_FORWARDING_RULES] \
    [--layer4-configs=LAYER_4_CONFIGS] \
    [--src-network-context=SRC_NETWORK_CONTEXT] \
    [--src-networks=SRC_VPC_NETWORKS] \
    [--src-ip-ranges=SRC_IP_RANGES] \
    [--src-address-groups=SRC_ADDRESS_GROUPS] \
    [--src-fqdns=SRC_DOMAIN_NAMES]
```

Replace the following:

- `PRIORITY`: the numeric evaluation order of the rule within the policy. The rules are evaluated from highest to lowest priority, where `0` is the highest priority. Priorities must be unique for each rule. We recommend that you separate rule priority values by more than just a difference of one (for example, `100`, `200`, `300`) so that you can create new rules between the existing rules later.
- `POLICY_NAME`: the name of the regional network firewall policy in which you want to create the rule.
- `PROJECT_ID`: the project ID that contains the regional network firewall policy.
- `POLICY_REGION`: the region of the policy.
- `DESCRIPTION`: an optional description for the new rule.
- `ACTION`: specify one of the following actions:

  <br />

  - `allow`: allows connections that match the rule.
  - `deny`: denies connections that match the rule.
  - `goto_next`: continues the [firewall rule evaluation
    process](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-eval-order#default-rule-evaluation).
- The `--enable-logging` and `--no-enable-logging` flags enable or disable VPC firewall rules logging.
- The `--disabled` and `--no-disabled` flags control whether the rule is disabled (not enforced) or enabled (enforced).
- Specify a [target](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details.md.txt#targets):

  <br />

  - If you omit the `--target-forwarding-rules` flag, Cloud NGFW uses the [broadest load balancer
    targets](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#target-lb-broadest).
  - `TARGET_FORWARDING_RULES`: a single forwarding rule for an internal Application Load Balancer or internal proxy Network Load Balancer specified in the [target
    forwarding rules
    format](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#target-lb-specific-format). This parameter narrows the broadest load balancer targets to a specific internal Application Load Balancer or internal proxy Network Load Balancer.

<!-- -->

- `LAYER_4_CONFIGS`: specify `tcp` or IANA protocol number `6`. Firewall rules targeting internal load balancers (`INTERNAL_MANAGED_LB`) support only the TCP protocol. Don't specify destination ports or port ranges. Filtering applies to all traffic directed to the forwarding rule of the load balancer.

<!-- -->

- Specify a [source for the ingress
  rule](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-ingress-src). For more information, [Ingress rule source
  combinations](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-ingress-src-combinations):

  <br />

  - `SRC_NETWORK_CONTEXT`: defines a source network contexts to be used in conjunction with another supported source parameter to produce a source combination. Valid values when `--target-type=INTERNAL_MANAGED_LB` are `VPC_NETWORKS` or `INTRA_VPC`. For more information, see [Network contexts](https://docs.cloud.google.com/firewall/docs/understand-network-contexts.md.txt).
  - `SRC_VPC_NETWORKS`: a comma-separated list of VPC networks specified by their URL identifiers. Specify this flag only when the `--src-network-context` is `VPC_NETWORKS`.
  - `SRC_IP_RANGES`: a comma-separated list of IP address ranges in CIDR format. Ranges in the list must all be either IPv4 CIDRs or IPv6 CIDRs, not a combination of both.
  - `SRC_ADDRESS_GROUPS`: a comma-separated list of address groups specified by their [unique URL
    identifiers](https://docs.cloud.google.com/firewall/docs/address-groups-firewall-policies#address-group-specification). Address groups in the list must contain all IPv4 addresses or all IPv6 addresses, not a combination of both.
  - `SRC_DOMAIN_NAMES`: a comma-separated list of FQDN objects specified in the [domain name
    format](https://docs.cloud.google.com/firewall/docs/fqdn-objects-overview#domain-name-format).

<br />

### Create an egress rule for VM targets

#### Permissions required for this task

To perform this task, you must have been granted the following permissions
*or* one of the following IAM roles.

**Permissions**

- `compute.regionFirewallPolicies.update`

**Roles**

- Compute Security Admin (`roles/compute.securityAdmin`) on the firewall policy or project containing the firewall policy


The following directions show how to create an [egress
rule](https://docs.cloud.google.com/firewall/docs/firewall-policies-overview#egress_rules). Egress rules
only apply to targets that are network interfaces of Compute Engine
instances.


### Console


1. In the Google Cloud console, go to the **Firewall policies** page.

   [Go to Firewall policies](https://console.cloud.google.com/net-security/firewall-manager/firewall-policies/list)
2. In the project selector list, select a project that contains a
   regional network firewall policy.

3. In the **Network firewall policies** section, click the name of a
   regional network firewall policy in which you want to create a rule.

4. In the **Firewall rules** section, click **Create firewall rule** and
   specify the following configuration parameters:

   1. **Priority**: the numeric evaluation order of the rule.

      The rules are evaluated from highest to lowest priority where `0`
      is the highest priority. Priorities must be unique for each rule.
      We recommend that you separate rule priority values by more than
      just a difference of one (for example, `100`, `200`, `300`) so
      that you can create new rules between the existing rules later.
   2. **Description**: provide an optional description.

   3.


      **Target type** : select **Instances**.

      When you select this option, Cloud NGFW uses VM instances as the
      target.

   4.

      **Target**: select one of the following:
      - **Apply to all** : Cloud NGFW uses the [broadest instance
        targets](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#target-vm-broadest).
      - **Service accounts** : narrows the broadest instance targets to the network interfaces of VM instances that use the service account you specify:

        <br />

        - In the **Service account scope** section, select **In this
          project \> Target service account**. This is to specify a service account in the same project as the regional network firewall policy.
        - In the **Service account scope** section, select **In another
          project \> Target service account**. This is to specify a service account in a Shared VPC service project.
      - **Secure tags** : narrows the broadest instance targets to the network interfaces of VM instances that are bound to at least one of the [secure
        tag](https://docs.cloud.google.com/firewall/docs/tags-firewalls-overview) values that you specify. Click **Select scope for tags** and select the organization or project that contains the tag values to match. To add more tag values, click **Add tag**.

      <br />

   5. **Direction of traffic** : select **Egress**.

   6.
      **Action on match**: select one of the following:

      - **Allow**: to permit connections that match the rule parameters.
      - **Deny**: to block connections that match the rule parameters.
      - **Go to next** : to continue the [firewall rule evaluation
        process](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-eval-order#default-rule-evaluation).

      <br />

   7. **Logs** : select **Enabled** to enable firewall rules logging or
      **Disabled** to disable firewall rules logging for this rule.

   8.
      **Destination network context** : specify a
      [network context](https://docs.cloud.google.com/firewall/docs/understand-network-contexts.md.txt):

      - To skip filtering outgoing traffic by network context, select **All network contexts**.
      - To filter outgoing traffic to a specific network context, select **Specific network context** , and then select a network context:
        - **Internet** : outgoing traffic must match the [Internet
          network context for egress
          packets](https://docs.cloud.google.com/firewall/docs/understand-network-contexts#internet-context-egress).
        - **Non-internet** : outgoing traffic must match the [Non-internet network context for egress
          packets](https://docs.cloud.google.com/firewall/docs/understand-network-contexts#non-internet-egress).

      <br />

   9.
      **Destination filters** : specify additional destination parameters. Some
      destination parameters can't be used together, and your choice of destination
      network context limits which destination filters you can use. For more
      information, see [Destinations for egress
      rules](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-egress-dest) and
      [Egress rule destination
      combinations](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-egress-dest-combinations).

      - To filter outgoing traffic by destination IPv4 ranges, select **IPv4** , and then enter the CIDR blocks in the **IP ranges** field. Use `0.0.0.0/0` for any IPv4 destination.
      - To filter outgoing traffic by destination IPv6 ranges, select **IPv6** , and then enter the CIDR blocks into the **IPv6 ranges** field. Use `::/0` for any IPv6 destination.
      - To filter outgoing traffic by destination FQDN, enter FQDNs in the **FQDNs** field. For more information, see [FQDN
        objects](https://docs.cloud.google.com/firewall/docs/fqdn-objects-overview).
      - To filter outgoing traffic by destination geolocation, select one or more locations from the **Geolocations** field. For more information, see [Geolocation
        objects](https://docs.cloud.google.com/firewall/docs/geolocation-objects-overview).
      - To filter outgoing traffic by destination address group, select one or more address groups from the **Address groups** field. For more information, see [Address groups for firewall
        policies](https://docs.cloud.google.com/firewall/docs/address-groups-firewall-policies).
      - To filter outgoing traffic by destination Google Threat Intelligence lists, select one or more Google Threat Intelligence lists from the **Google Cloud Threat Intelligence** field. For more information, see [Google Threat Intelligence for firewall policy
        rules](https://docs.cloud.google.com/firewall/docs/threat-intelligence-overview).

      <br />

   10.
       **Source** : specify optional source parameters. For more information, see
       [Sources for egress
       rules](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-egress-src).

       - To skip filtering outgoing traffic by source IP address, select **None**.
       - To filter outgoing traffic to by source IP address, select **IPv4** or **IPv6** and then enter one or more CIDRs using the same format used for destination IPv4 ranges or destination IPv6 ranges.

       <br />

   11. **Protocols and ports** : specify the protocols and destination ports
       for traffic to match the rule. For more information, see [Protocols
       and
       ports](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#protocols_and_ports).

   12. **Enforcement**: specify whether the firewall rule is enforced or
       not:

       - **Enabled**: creates the rule and begins enforcing the rule on new connections.
       - **Disabled**: creates the rule but doesn't enforce the rule on new connections.
5. Click **Create**.

<br />

### gcloud


```
gcloud compute network-firewall-policies rules create PRIORITY \
    --firewall-policy=POLICY_NAME \
    --project=PROJECT_ID \
    --firewall-policy-region=POLICY_REGION \
    --description=DESCRIPTION \
    --direction=EGRESS \
    --action=ACTION \
    [--enable-logging | --no-enable-logging] \
    [--disabled | --no-disabled] \
    [--target-secure-tags=TARGET_SECURE_TAGS] \
    [--target-service-accounts=TARGET_SERVICE_ACCOUNTS] \
    [--layer4-configs=LAYER_4_CONFIGS] \
    [--dest-network-context=DEST_NETWORK_CONTEXT] \
    [--dest-ip-ranges=DEST_IP_RANGES] \
    [--dest-address-groups=DEST_ADDRESS_GROUPS] \
    [--dest-fqdns=DEST_DOMAIN_NAMES] \
    [--dest-region-codes=DEST_COUNTRY_CODES] \
    [--dest-threat-intelligence=DEST_THREAT_LIST_NAMES] \
    [--src-ip-ranges=SRC_IP_RANGES]
```

Replace the following:

- `PRIORITY`: the numeric evaluation order of the rule within the policy. The rules are evaluated from highest to lowest priority, where `0` is the highest priority. Priorities must be unique for each rule. We recommend that you separate rule priority values by more than just a difference of one (for example, `100`, `200`, `300`) so that you can create new rules between the existing rules later.
- `POLICY_NAME`: the name of the regional network firewall policy in which you want to create the rule.
- `PROJECT_ID`: the project ID that contains the regional network firewall policy.
- `POLICY_REGION`: the region of the policy.
- `DESCRIPTION`: an optional description for the new rule.
- `ACTION`: specify one of the following actions:

  <br />

  - `allow`: allows connections that match the rule.
  - `deny`: denies connections that match the rule.
  - `goto_next`: continues the [firewall rule evaluation
    process](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-eval-order#default-rule-evaluation).
- The `--enable-logging` and `--no-enable-logging` flags enable or disable VPC firewall rules logging.
- The `--disabled` and `--no-disabled` flags control whether the rule is disabled (not enforced) or enabled (enforced).
- Specify a [target](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details.md.txt#targets):

  <br />

  - If you omit both the `--target-secure-tags` and `--target-service-accounts` flags, Cloud NGFW uses the [broadest instance
    targets](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#target-vm-broadest).
  - `TARGET_SECURE_TAGS`: a comma-separated list of [secure
    tag](https://docs.cloud.google.com/firewall/docs/tags-firewalls-overview) values that narrows the broadest instance targets to the network interfaces of VM instances that are bound to at least one of the secure tag values.
  - `TARGET_SERVICE_ACCOUNTS`: a comma-separated list of service accounts that narrows the broadest instance targets to the network interfaces of VM instances that use one of the service accounts.

<!-- -->

- `LAYER_4_CONFIGS`: a comma-separated list of Layer 4
  configs. Each Layer 4 config can be one of the following:

  - An IP protocol name (`tcp`) or IANA IP protocol number (`6`) without any destination port.
  - An IP protocol name and destination port separated by a colon (`tcp:80`).
  - An IP protocol name and destination port range separated by a colon using a dash to separate the beginning and ending destination ports (`tcp:5000-6000`).

  For more information, see [Protocols and
  ports](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#protocols_and_ports).

<!-- -->

- Specify a [destination for the egress
  rule](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-egress-dest). For more information, [Egress rule destination
  combinations](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-egress-dest-combinations):

  <br />

  - `DEST_NETWORK_CONTEXT`: defines a destination network contexts to be used in conjunction with another supported destination parameter to produce a destination combination. Valid values are `INTERNET` and `NON_INTERNET`. For more information, see [Network contexts](https://docs.cloud.google.com/firewall/docs/understand-network-contexts.md.txt).
  - `DEST_IP_RANGES`: a comma-separated list of IP address ranges in CIDR format. Ranges in the list must all be either IPv4 CIDRs or IPv6 CIDRs, not a combination of both.
  - `DEST_ADDRESS_GROUPS`: a comma-separated list of address groups specified by their [unique URL
    identifiers](https://docs.cloud.google.com/firewall/docs/address-groups-firewall-policies#address-group-specification).
  - `DEST_DOMAIN_NAMES`: a comma-separated list of FQDN objects specified in the [domain name
    format](https://docs.cloud.google.com/firewall/docs/fqdn-objects-overview#domain-name-format).
  - `DEST_COUNTRY_CODES`: a comma-separated list of two-letter country codes. For more information, see [Geolocation
    objects](https://docs.cloud.google.com/firewall/docs/geolocation-objects-overview).
  - `DEST_THREAT_LIST_NAMES`: a comma-separated list of names of Google Threat Intelligence lists. For more information, see [Google Threat Intelligence for
    firewall policy
    rules](https://docs.cloud.google.com/firewall/docs/threat-intelligence-overview).
- Optionally, specify a [source for the egress
  rule](https://docs.cloud.google.com/firewall/docs/firewall-policies-rule-details#hfp-nfp-egress-src):

  <br />

  - `SRC_IP_RANGES`: a comma-separated list of IP address ranges in CIDR format. Ranges in the list must all be either IPv4 CIDRs or IPv6 CIDRs, not a combination of both.

<br />

## What's next

- [Regional network firewall policies](https://docs.cloud.google.com/firewall/docs/regional-firewall-policies.md.txt)
- [Manage regional network firewall policies](https://docs.cloud.google.com/firewall/docs/manage-regional-firewall-policies.md.txt)
- [Hierarchical firewall policies](https://docs.cloud.google.com/firewall/docs/firewall-policies.md.txt)
- [Create global network firewall policies and rules](https://docs.cloud.google.com/firewall/docs/use-network-firewall-policies.md.txt)