opentf/website/source/docs/providers/rancher/r/host.html.markdown

layout, page_title, sidebar_current, description

layout	page_title	sidebar_current	description
rancher	Rancher: rancher_host	docs-rancher-resource-host	Provides a Rancher Host resource. This can be used to manage and delete hosts on Rancher.

rancher_host

Provides a Rancher Host resource. This can be used to manage and delete hosts on Rancher.

Example usage

# Manage an existing Rancher host
resource rancher_host "foo" {
  name           = "foo"
  description    = "The foo node"
  environment_id = "1a5"
  hostname       = "foo.example.com"
  labels {
    role = "database"
  }
}

Argument Reference

The following arguments are supported:

• name - (Required) The name of the host.
• description - (Optional) A host description.
• environment_id - (Required) The ID of the environment the host is associated to.
• hostname - (Required) The host name. Used as the primary key to detect the host ID.
• labels - (Optional) A dictionary of labels to apply to the host. Computed internal labels are excluded from that list.