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
}
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.
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 numbername
- String port namestatus
- String description of current state of the instance.