* Add new data source: compute region instance group manager's groups. * Add documentation for wait_for_instances and for the timeout mechanism in resourceComputeRegionInstanceGroupManagerCreate.
2.3 KiB
layout | page_title | sidebar_current | description |
---|---|---|---|
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 ofname
orself_link
must be provided. -
self_link
- (Optional) The link to the instance group. One ofname
orself_link
must be provided.
-
project
- (Optional) The project in which the resource belongs. If it is not provided, the provider project is used. -
region
- (Optional) The region in which the resource belongs. Ifself_link
is provided, this value is ignored. If neitherself_link
norregion
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 numbername
- String port name
status
- String description of current state of the instance.