mirror of
https://github.com/letic/terraform-provider-google.git
synced 2024-10-15 07:27:15 +00:00
68 lines
2.3 KiB
Markdown
68 lines
2.3 KiB
Markdown
|
---
|
||
|
layout: "google"
|
||
|
page_title: "Google: google_compute_region_instance_group"
|
||
|
sidebar_current: "docs-google-datasource-compute-region-instance-group"
|
||
|
description: |-
|
||
|
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](https://cloud.google.com/compute/docs/instance-groups/distributing-instances-with-regional-instance-groups) and [API](https://cloud.google.com/compute/docs/reference/latest/regionInstanceGroups).
|
||
|
|
||
|
```
|
||
|
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 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. 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.
|