github.com/minamijoyo/terraform@v0.7.8-0.20161029001309-18b3736ba44b/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  
    32  ## Argument Reference
    33  
    34  
    35  The following arguments are supported:
    36  
    37  * `name` - (Required, string) The name (or GUID) of this server group. Will resolve to existing if present.
    38  * `parent` - (Required, string) The name or ID of the parent group. Will error if absent or unable to resolve.
    39  * `location_id` - (Required, string) The datacenter location of both parent group and this group.
    40     Examples: "WA1", "VA1"
    41  * `description` - (Optional, string) Description for server group (visible in control portal only)
    42  * `custom_fields` - (Optional) See [CustomFields](#custom_fields) below for details.
    43  
    44  
    45  
    46  <a id="custom_fields"></a>
    47  ## CustomFields
    48  
    49  `custom_fields` is a block within the configuration that may be
    50  repeated to bind custom fields for a server. CustomFields need be set
    51  up in advance. Each `custom_fields` block supports the following:
    52  
    53  * `id` - (Required, string) The ID of the custom field to set.
    54  * `value` - (Required, string) The value for the specified field. 
    55