github.com/vtorhonen/terraform@v0.9.0-beta2.0.20170307220345-5d894e4ffda7/website/source/docs/providers/clc/r/group.html.markdown (about)

     1  ---
     2  layout: "clc"
     3  page_title: "clc: clc_group"
     4  sidebar_current: "docs-clc-resource-group"
     5  description: |-
     6    Manages a CLC server group.
     7  ---
     8  
     9  # clc\_group
    10  
    11  Manages a CLC server group. Either provisions or resolves to an existing group.
    12  
    13  See also [Complete API documentation](https://www.ctl.io/api-docs/v2/#groups).
    14  
    15  ## Example Usage
    16  
    17  ```
    18  # Provision/Resolve a server group
    19  resource "clc_group" "frontends" {
    20    location_id = "WA1"
    21    name        = "frontends"
    22    parent      = "Default Group"
    23  }
    24  
    25  output "group_id" {
    26    value = "clc_group.frontends.id"
    27  }
    28  ```
    29  
    30  
    31  ## Argument Reference
    32  
    33  
    34  The following arguments are supported:
    35  
    36  * `name` - (Required, string) The name (or GUID) of this server group. Will resolve to existing if present.
    37  * `parent` - (Required, string) The name or ID of the parent group. Will error if absent or unable to resolve.
    38  * `location_id` - (Required, string) The datacenter location of both parent group and this group.
    39     Examples: "WA1", "VA1"
    40  * `description` - (Optional, string) Description for server group (visible in control portal only)
    41  * `custom_fields` - (Optional) See [CustomFields](#custom_fields) below for details.
    42  
    43  
    44  
    45  <a id="custom_fields"></a>
    46  ## CustomFields
    47  
    48  `custom_fields` is a block within the configuration that may be
    49  repeated to bind custom fields for a server. CustomFields need be set
    50  up in advance. Each `custom_fields` block supports the following:
    51  
    52  * `id` - (Required, string) The ID of the custom field to set.
    53  * `value` - (Required, string) The value for the specified field.
    54