github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/rancher/r/host.html.markdown (about)

     1  ---
     2  layout: "rancher"
     3  page_title: "Rancher: rancher_host"
     4  sidebar_current: "docs-rancher-resource-host"
     5  description: |-
     6    Provides a Rancher Host resource. This can be used to manage and delete hosts on Rancher.
     7  ---
     8  
     9  # rancher\_host
    10  
    11  Provides a Rancher Host resource. This can be used to manage and delete hosts on Rancher.
    12  
    13  ## Example usage
    14  
    15  ```hcl
    16  # Manage an existing Rancher host
    17  resource rancher_host "foo" {
    18    name           = "foo"
    19    description    = "The foo node"
    20    environment_id = "1a5"
    21    hostname       = "foo.example.com"
    22    labels {
    23      role = "database"
    24    }
    25  }
    26  ```
    27  
    28  ## Argument Reference
    29  
    30  The following arguments are supported:
    31  
    32  * `name` - (Required) The name of the host.
    33  * `description` - (Optional) A host description.
    34  * `environment_id` - (Required) The ID of the environment the host is associated to.
    35  * `hostname` - (Required) The host name. Used as the primary key to detect the host ID.
    36  * `labels` - (Optional) A dictionary of labels to apply to the host. Computed internal labels are excluded from that list.