opentf/website/source/docs/providers/google/r/compute_instance.html.markdown

layout, page_title, sidebar_current, description

layout	page_title	sidebar_current	description
google	Google: google_compute_instance	docs-google-resource-instance	Manages a VM instance resource within GCE.

google_compute_instance

Manages a VM instance resource within GCE. For more information see the official documentation and API.

Example Usage

resource "google_compute_instance" "default" {
	name = "test"
	machine_type = "n1-standard-1"
	zone = "us-central1-a"
	tags = ["foo", "bar"]

	disk {
		image = "debian-7-wheezy-v20140814"
	}

	network {
		source = "default"
	}

	metadata {
		foo = "bar"
	}

	service_account {
		scopes = ["userinfo-email", "compute-ro", "storage-ro"]
	}
}

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.

• description - (Optional) A brief description of this resource.

• machine_type - (Required) The machine type to create.

• zone - (Required) The zone that the machine should be created in.

• disk - (Required) Disks to attach to the instance. This can be specified multiple times for multiple disks. Structure is documented below.

• can_ip_forward - (Optional) Whether to allow sending and receiving of packets with non-matching source or destination IPs. This defaults to false.

• metadata - (Optional) Metadata key/value pairs to make available from within the instance.

• network - (Required) Networks to attach to the instance. This can be specified multiple times for multiple networks. Structure is documented below.

• service_account - (Optional) Service account to attach to the instance.

• tags - (Optional) Tags to attach to the instance.

The disk block supports:

• disk - (Required if image not set) The name of the disk (such as those managed by google_compute_disk) to attach.

• image - (Required if disk not set) The name of the image to base this disk off of.

• auto_delete - (Optional) Whether or not the disk should be auto-deleted. This defaults to true.

• type - (Optional) The GCE disk type.

The network block supports:

• source - (Required) The name of the network to attach this interface to.

• address - (Optional) The IP address of a reserved IP address to assign to this interface.

The service_account block supports:

• scopes - (Required) A list of service scopes. Both OAuth2 URLs and gcloud short names are supported.

Attributes Reference

The following attributes are exported:

• name - The name of the resource.
• machine_type - The type of machine.
• zone - The zone the machine lives in.