terraform-provider-google/website/docs/d/datasource_compute_region_instance_group.html.markdown

layout	page_title	sidebar_current	description
google	Google: google_compute_region_instance_group	docs-google-datasource-compute-region-instance-group	Get the instances inside a Compute Region Instance Group within GCE.

google_compute_region_instance_group

Get a Compute Region Instance Group within GCE. For more information, see the official documentation and API.

data "google_compute_region_instance_group" "group" {
	name = "instance-group-name"
}

The most common use of this datasource will be to fetch information about the instances inside regional managed instance groups, for instance:

resource "google_compute_region_instance_group_manager" "foo" {
	name = "some_name"
    ...
	base_instance_name = "foo"
    ...
	instance_template = "${google_compute_instance_template.foo.self_link}"
	target_pools = ["${google_compute_target_pool.foo.self_link}"]
    ...
}

data "google_compute_region_instance_group" "data_source" {
	self_link = "${google_compute_region_instance_group_manager.foo.instance_group}"
}

Argument Reference

The following arguments are supported:

• name - (Optional) The name of the instance group. One of name or self_link must be provided.

• self_link - (Optional) The link to the instance group. One of name or self_link must be provided.

---

• project - (Optional) The ID of the project in which the resource belongs. If self_link is provided, this value is ignored. If neither self_link nor project are provided, the provider project is used.

• region - (Optional) The region in which the resource belongs. If self_link is provided, this value is ignored. If neither self_link nor region are provided, the provider region is used.

Attributes Reference

The following arguments are exported:

• size - The number of instances in the group.

• instances - List of instances in the group, as a list of resources, each containing:

  • instance - URL to the instance.
  • named_ports - List of named ports in the group, as a list of resources, each containing:
    • port - Integer port number
    • name - String port name
  • status - String description of current state of the instance.