---
title: "openstack_networking_secgroup_rule_v2"
description: ""
sidebar_position: 12
---

# openstack\_networking\_secgroup\_rule\_v2

:::info

This instruction is a copy of the official OpenStack Terraform provider documentation from the [Terraform Registry](https://registry.terraform.io/providers/terraform-provider-openstack/openstack/latest/docs).

:::

Manages a V2 neutron security group rule resource within OpenStack. Unlike Nova security groups, neutron separates the group from the rules and also allows an admin to target a specific tenant\_id.

## Example Usage

```hcl
resource "openstack_networking_secgroup_v2" "secgroup_1" {
  name        = "secgroup_1"
  description = "My neutron security group"
}

resource "openstack_networking_secgroup_rule_v2" "secgroup_rule_1" {
  direction         = "ingress"
  ethertype         = "IPv4"
  protocol          = "tcp"
  port_range_min    = 22
  port_range_max    = 22
  remote_ip_prefix  = "0.0.0.0/0"
  security_group_id = openstack_networking_secgroup_v2.secgroup_1.id
}
```

\~> **Note** To expose the full port range 1:65535, use `0` for `port_range_min` and `port_range_max`.

## Argument Reference

The following arguments are supported:

* `region` — (Optional) The region in which to obtain the V2 networking client. A networking client is needed to create a port. If omitted, the `region` argument of the provider is used. Changing this creates a new security group rule.

* `description` — (Optional) A description of the rule. Changing this creates a new security group rule.

* `direction` — (Required) The direction of the rule, valid values are `ingress` or `egress`. Changing this creates a new security group rule.

* `ethertype` — (Required) The layer 3 protocol type, valid values are `IPv4` or `IPv6`. Changing this creates a new security group rule.

* `protocol` — (Optional) The layer 4 protocol type, valid values are as follows. Changing this creates a new security group rule. This is required if you want to specify a port range.
  * empty string or omitted (any protocol)
  * integer value between 0 and 255 (valid IP protocol number)
  * `tcp`
  * `udp`
  * `icmp`
  * `ah`
  * `dccp`
  * `egp`
  * `esp`
  * `gre`
  * `igmp`
  * `ipv6-encap`
  * `ipv6-frag`
  * `ipv6-icmp`
  * `ipv6-nonxt`
  * `ipv6-opts`
  * `ipv6-route`
  * `ospf`
  * `pgm`
  * `rsvp`
  * `sctp`
  * `udplite`
  * `vrrp`
  * `ipip`

* `port_range_min` — (Optional) The lower part of the allowed port range, a valid integer value between 1 and 65535. Changing this creates a new security group rule.

* `port_range_max` — (Optional) The higher part of the allowed port range, a valid integer value between 1 and 65535. Changing this creates a new security group rule.

* `remote_ip_prefix` — (Optional) The remote CIDR, the value must be a valid CIDR (e.g., 192.168.0.0/16). Changing this creates a new security group rule.

* `remote_group_id` — (Optional) The remote group ID; the value must be an OpenStack ID of a security group in the same tenant. Changing this creates a new security group rule.

* `security_group_id` — (Required) The security group ID the rule should belong to; the value must be an OpenStack ID of a security group in the same tenant. Changing this creates a new security group rule.

* `tenant_id` — (Optional) The owner of the security group. Required if an admin wants to create a port for another tenant. Changing this creates a new security group rule.

## Attributes Reference

The following attributes are exported:

* `region` — See Argument Reference above.
* `description` — See Argument Reference above.
* `direction` — See Argument Reference above.
* `ethertype` — See Argument Reference above.
* `protocol` — See Argument Reference above.
* `port_range_min` — See Argument Reference above.
* `port_range_max` — See Argument Reference above.
* `remote_ip_prefix` — See Argument Reference above.
* `remote_group_id` — See Argument Reference above.
* `security_group_id` — See Argument Reference above.
* `tenant_id` — See Argument Reference above.

## Import

Security Group Rules can be imported using the `id`, e.g.

```
$ terraform import openstack_networking_secgroup_rule_v2.secgroup_rule_1 aeb68ee3-6e9d-4256-955c-9584a6212745
```