terraform-provider-google/website/docs/r/compute_subnetwork.html.markdown

layout	page_title	sidebar_current	description
google	Google: google_compute_subnetwork	docs-google-compute-subnetwork-x	Manages a subnetwork within GCE.

google_compute_subnetwork

Manages a subnetwork within GCE. For more information see the official documentation and API.

Example Usage

resource "google_compute_subnetwork" "default-us-east1" {
  name          = "default-us-east1"
  ip_cidr_range = "10.0.0.0/16"
  network       = "${google_compute_network.default.self_link}"
  region        = "us-east1"
}

resource "google_compute_network" "default" {
  name = "test"
}

Argument Reference

The following arguments are supported:

• ip_cidr_range - (Required) The IP address range that machines in this network are assigned to, represented as a CIDR block.

• name - (Required) A unique name for the resource, required by GCE. Changing this forces a new resource to be created.

• network - (Required) The network name or resource link to the parent network of this subnetwork. The parent network must have been created in custom subnet mode.

---

• description - (Optional) Description of this subnetwork.

• project - (Optional) The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

• region - (Optional) The region this subnetwork will be created in. If unspecified, this defaults to the region configured in the provider.

• private_ip_google_access - (Optional) Whether the VMs in this subnet can access Google services without assigned external IP addresses.

• enable_flow_logs - (Optional, Beta) Set to true to enable flow logs for this subnetwork.

---

• secondary_ip_range - (Optional, Beta) An array of configurations for secondary IP ranges for VM instances contained in this subnetwork. Structure is documented below.

The secondary_ip_range block supports:

• range_name - (Required) The name associated with this subnetwork secondary range, used when adding an alias IP range to a VM instance.

• ip_cidr_range - (Required) The range of IP addresses belonging to this subnetwork secondary range. Ranges must be unique and non-overlapping with all primary and secondary IP ranges within a network.

Attributes Reference

In addition to the arguments listed above, the following computed attributes are exported:

• gateway_address - The IP address of the gateway.

• self_link - The URI of the created resource.

Timeouts

This resource provides the following Timeouts configuration options:

• create - Default is 6 minutes
• update - Default is 6 minutes
• delete - Default is 6 minutes

Import

Subnetwork can be imported using the region and name, e.g.

$ terraform import google_compute_subnetwork.default-us-east1 us-east1/default-us-east1