github.com/chalford/terraform@v0.3.7-0.20150113080010-a78c69a8c81f/website/source/docs/providers/cloudstack/r/instance.html.markdown (about)

     1  ---
     2  layout: "cloudstack"
     3  page_title: "CloudStack: cloudstack_instance"
     4  sidebar_current: "docs-cloudstack-resource-instance"
     5  description: |-
     6    Creates and automatically starts a virtual machine based on a service offering, disk offering, and template.
     7  ---
     8  
     9  # cloudstack\_instance
    10  
    11  Creates and automatically starts a virtual machine based on a service offering,
    12  disk offering, and template.
    13  
    14  ## Example Usage
    15  
    16  ```
    17  resource "cloudstack_instance" "web" {
    18      ami = "ami-1234"
    19      instance_type = "m1.small"
    20      tags {
    21          Name = "HelloWorld"
    22      }
    23  }
    24  ```
    25  
    26  ## Argument Reference
    27  
    28  The following arguments are supported:
    29  
    30  * `name` - (Required) The name of the instance. Changing this forces a new
    31      resource to be created.
    32  
    33  * `display_name` - (Optional) The display name of the instance.
    34  
    35  * `service_offering` - (Required) The service offering used for this instance.
    36  
    37  * `network` - (Optional) The name of the network to connect this instance to.
    38      Changing this forces a new resource to be created.
    39  
    40  * `ipaddress` - (Optional) The IP address to assign to this instance. Changing
    41      this forces a new resource to be created.
    42  
    43  * `template` - (Required) The name of the template used for this instance.
    44      Changing this forces a new resource to be created.
    45  
    46  * `zone` - (Required) The name of the zone where this instance will be created.
    47      Changing this forces a new resource to be created.
    48  
    49  * `user_data` - (Optional) The user data to provide when launching the instance.
    50  
    51  * `expunge` - (Optional) This determines if the instance is expunged when it is
    52      destroyed (defaults false)
    53  
    54  ## Attributes Reference
    55  
    56  The following attributes are exported:
    57  
    58  * `id` - The instance ID.
    59  * `display_name` - The display name of the instance.