Paul TyngandJeff Malnick
8bb38f1fd6
* Cleanup some of the repo, prep for release * Rework docs to new registry structure * Add docs generator tooling * Generate the docs * update deps * docs: add docs generation command to readme Co-authored-by: Jeff Malnick <malnick@gmail.com>
73 lines
2.1 KiB
Markdown
73 lines
2.1 KiB
Markdown
---
|
|
page_title: "boundary_host_set Resource - terraform-provider-boundary"
|
|
subcategory: ""
|
|
description: |-
|
|
The host_set resource allows you to configure a Boundary host set. Host sets are always part of a host catalog, so a host catalog resource should be used inline or you should have the host catalog ID in hand to successfully configure a host set.
|
|
---
|
|
|
|
# Resource `boundary_host_set`
|
|
|
|
The host_set resource allows you to configure a Boundary host set. Host sets are always part of a host catalog, so a host catalog resource should be used inline or you should have the host catalog ID in hand to successfully configure a host set.
|
|
|
|
## Example Usage
|
|
|
|
```terraform
|
|
resource "boundary_scope" "org" {
|
|
name = "organization_one"
|
|
description = "My first scope!"
|
|
scope_id = "global"
|
|
auto_create_role = true
|
|
}
|
|
|
|
resource "boundary_scope" "project" {
|
|
name = "project_one"
|
|
description = "My first scope!"
|
|
scope_id = boundary_scope.org.id
|
|
auto_create_role = true
|
|
}
|
|
|
|
resource "boundary_host_catalog" "static" {
|
|
scope_id = boundary_scope.project.id
|
|
}
|
|
|
|
resource "boundary_host" "1" {
|
|
name = "host_1"
|
|
description = "My first host!"
|
|
address = "10.0.0.1"
|
|
host_catalog_id = boundary_host_catalog.static.id
|
|
scope_id = boundary_scope.project.id
|
|
}
|
|
|
|
resource "boundary_host" "2" {
|
|
name = "host_2"
|
|
description = "My second host!"
|
|
address = "10.0.0.2"
|
|
host_catalog_id = boundary_host_catalog.static.id
|
|
scope_id = boundary_scope.project.id
|
|
}
|
|
|
|
resource "boundary_host_set" "web" {
|
|
host_catalog_id = boundary_host_catalog.static.id
|
|
host_ids = [
|
|
boundary_host.1.id,
|
|
boundary_host.2.id,
|
|
]
|
|
}
|
|
```
|
|
|
|
## Schema
|
|
|
|
### Required
|
|
|
|
- **host_catalog_id** (String, Required) The catalog for the hostset.
|
|
- **type** (String, Required)
|
|
|
|
### Optional
|
|
|
|
- **description** (String, Optional) The hostset description.
|
|
- **host_ids** (Set of String, Optional) The list of host IDs contained in this set.
|
|
- **id** (String, Optional) The ID of this resource.
|
|
- **name** (String, Optional) The hostset name. Defaults to the resource name.
|
|
|
|
|