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

     1  ---
     2  layout: "cloudstack"
     3  page_title: "CloudStack: cloudstack_template"
     4  sidebar_current: "docs-cloudstack-resource-template"
     5  description: |-
     6    Registers an existing template into the CloudStack cloud.
     7  ---
     8  
     9  # cloudstack_template
    10  
    11  Registers an existing template into the CloudStack cloud.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  resource "cloudstack_template" "centos64" {
    17    name       = "CentOS 6.4 x64"
    18    format     = "VHD"
    19    hypervisor = "XenServer"
    20    os_type    = "CentOS 6.4 (64bit)"
    21    url        = "http://someurl.com/template.vhd"
    22    zone       = "zone-1"
    23  }
    24  ```
    25  
    26  ## Argument Reference
    27  
    28  The following arguments are supported:
    29  
    30  * `name` - (Required) The name of the template.
    31  
    32  * `display_text` - (Optional) The display name of the template.
    33  
    34  * `format` - (Required) The format of the template. Valid values are `QCOW2`,
    35      `RAW`, and `VHD`.
    36  
    37  * `hypervisor` - (Required) The target hypervisor for the template. Changing
    38      this forces a new resource to be created.
    39  
    40  * `os_type` - (Required) The OS Type that best represents the OS of this
    41      template.
    42  
    43  * `url` - (Required) The URL of where the template is hosted. Changing this
    44      forces a new resource to be created.
    45  
    46  * `project` - (Optional) The name or ID of the project to create this template for.
    47      Changing this forces a new resource to be created.
    48  
    49  * `zone` - (Required) The name or ID of the zone where this template will be created.
    50      Changing this forces a new resource to be created.
    51  
    52  * `is_dynamically_scalable` - (Optional) Set to indicate if the template contains
    53      tools to support dynamic scaling of VM cpu/memory (defaults false)
    54  
    55  * `is_extractable` - (Optional) Set to indicate if the template is extractable
    56      (defaults false)
    57  
    58  * `is_featured` - (Optional) Set to indicate if the template is featured
    59      (defaults false)
    60  
    61  * `is_public` - (Optional) Set to indicate if the template is available for
    62      all accounts (defaults true)
    63  
    64  * `password_enabled` - (Optional) Set to indicate if the template should be
    65      password enabled (defaults false)
    66  
    67  * `is_ready_timeout` - (Optional) The maximum time in seconds to wait until the
    68      template is ready for use (defaults 300 seconds)
    69  
    70  ## Attributes Reference
    71  
    72  The following attributes are exported:
    73  
    74  * `id` - The template ID.
    75  * `display_text` - The display text of the template.
    76  * `is_dynamically_scalable` - Set to "true" if the template is dynamically scalable.
    77  * `is_extractable` - Set to "true" if the template is extractable.
    78  * `is_featured` - Set to "true" if the template is featured.
    79  * `is_public` - Set to "true" if the template is public.
    80  * `password_enabled` - Set to "true" if the template is password enabled.
    81  * `is_ready` - Set to "true" once the template is ready for use.