github.com/hobbeswalsh/terraform@v0.3.7-0.20150619183303-ad17cf55a0fa/website/source/docs/providers/openstack/r/fw_rule_v1.html.markdown (about)

     1  ---
     2  layout: "openstack"
     3  page_title: "OpenStack: openstack_fw_rule_v1"
     4  sidebar_current: "docs-openstack-resource-fw-rule-v1"
     5  description: |-
     6    Manages a v1 firewall rule resource within OpenStack.
     7  ---
     8  
     9  # openstack\_fw\_rule_v1
    10  
    11  Manages a v1 firewall rule resource within OpenStack.
    12  
    13  ## Example Usage
    14  
    15  ```
    16  resource "openstack_fw_rule_v1" "rule_1" {
    17    name = "my_rule"
    18    description = "drop TELNET traffic"
    19    action = "deny"
    20    protocol = "tcp"
    21    destination_port = "23"
    22    enabled = "true"
    23  }
    24  ```
    25  
    26  ## Argument Reference
    27  
    28  The following arguments are supported:
    29  
    30  * `region` - (Required) The region in which to obtain the v1 Compute client.
    31      A Compute client is needed to create a firewall rule. If omitted, the
    32      `OS_REGION_NAME` environment variable is used. Changing this creates a new
    33      firewall rule.
    34  
    35  * `name` - (Optional) A unique name for the firewall rule. Changing this
    36      updates the `name` of an existing firewall rule.
    37  
    38  * `description` - (Optional) A description for the firewall rule. Changing this
    39      updates the `description` of an existing firewall rule.
    40  
    41  * `protocol` - (Required) The protocol type on which the firewall rule operates.
    42      Changing this updates the `protocol` of an existing firewall rule.
    43  
    44  * `action` - (Required) Action to be taken ( must be "allow" or "deny") when the
    45      firewall rule matches. Changing this updates the `action` of an existing
    46      firewall rule.
    47  
    48  * `ip_version` - (Optional) IP version, either 4 (default) or 6. Changing this
    49      updates the `ip_version` of an existing firewall rule.
    50  
    51  * `source_ip_address` - (Optional) The source IP address on which the firewall
    52      rule operates. Changing this updates the `source_ip_address` of an existing
    53      firewall rule.
    54  
    55  * `destination_ip_address` - (Optional) The destination IP address on which the
    56      firewall rule operates. Changing this updates the `destination_ip_address`
    57      of an existing firewall rule.
    58  
    59  * `source_port` - (Optional) The source port on which the firewall
    60      rule operates. Changing this updates the `source_port` of an existing
    61      firewall rule.
    62  
    63  * `destination_port` - (Optional) The destination port on which the firewall
    64      rule operates. Changing this updates the `destination_port` of an existing
    65      firewall rule.
    66  
    67  * `enabled` - (Optional) Enabled status for the firewall rule (must be "true"
    68      or "false" if provided - defaults to "true"). Changing this updates the
    69      `enabled` status of an existing firewall rule.
    70  
    71  * `tenant_id` - (Optional) The owner of the firewall rule. Required if admin
    72      wants to create a firewall rule for another tenant. Changing this creates a
    73      new firewall rule.
    74  
    75  ## Attributes Reference
    76  
    77  The following attributes are exported:
    78  
    79  * `region` - See Argument Reference above.
    80  * `name` - See Argument Reference above.
    81  * `description` - See Argument Reference above.
    82  * `protocol` - See Argument Reference above.
    83  * `action` - See Argument Reference above.
    84  * `ip_version` - See Argument Reference above.
    85  * `source_ip_address` - See Argument Reference above.
    86  * `destination_ip_address` - See Argument Reference above.
    87  * `source_port` - See Argument Reference above.
    88  * `destination_port` - See Argument Reference above.
    89  * `enabled` - See Argument Reference above.
    90  * `tenant_id` - See Argument Reference above.