terraform/website/source/docs/providers/google/r/compute_firewall.html.markdown

72 lines
1.7 KiB
Markdown
Raw Normal View History

2014-08-26 23:50:29 +02:00
---
layout: "google"
page_title: "Google: google_compute_firewall"
sidebar_current: "docs-google-compute-firewall"
2014-10-22 05:21:56 +02:00
description: |-
Manages a firewall resource within GCE.
2014-08-26 23:50:29 +02:00
---
# google\_compute\_firewall
Manages a firewall resource within GCE.
## Example Usage
```hcl
2014-08-26 23:50:29 +02:00
resource "google_compute_firewall" "default" {
name = "test"
network = "${google_compute_network.other.name}"
2014-08-26 23:50:29 +02:00
allow {
protocol = "icmp"
}
2014-08-26 23:50:29 +02:00
allow {
protocol = "tcp"
ports = ["80", "8080", "1000-2000"]
}
2014-08-26 23:50:29 +02:00
source_tags = ["web"]
2014-08-26 23:50:29 +02:00
}
```
## Argument Reference
The following arguments are supported:
* `name` - (Required) A unique name for the resource, required by GCE.
Changing this forces a new resource to be created.
* `network` - (Required) The name of the network to attach this firewall to.
* `allow` - (Required) Can be specified multiple times for each allow
rule. Each allow block supports fields documented below.
- - -
* `description` - (Optional) Textual description field.
* `project` - (Optional) The project in which the resource belongs. If it
is not provided, the provider project is used.
* `source_ranges` - (Optional) A list of source CIDR ranges that this
2014-08-26 23:50:29 +02:00
firewall applies to.
* `source_tags` - (Optional) A list of source tags for this firewall.
2014-09-27 21:42:46 +02:00
* `target_tags` - (Optional) A list of target tags for this firewall.
2014-08-26 23:50:29 +02:00
The `allow` block supports:
* `protocol` - (Required) The name of the protocol to allow.
* `ports` - (Optional) List of ports and/or port ranges to allow. This can
2014-08-26 23:50:29 +02:00
only be specified if the protocol is TCP or UDP.
## Attributes Reference
In addition to the arguments listed above, the following computed attributes are
exported:
2014-08-26 23:50:29 +02:00
* `self_link` - The URI of the created resource.