github.com/bengesoff/terraform@v0.3.1-0.20141018223233-b25a53629922/website/source/docs/providers/do/r/droplet.html.markdown (about)

     1  ---
     2  layout: "digitalocean"
     3  page_title: "DigitalOcean: digitalocean_droplet"
     4  sidebar_current: "docs-do-resource-droplet"
     5  ---
     6  
     7  # digitalocean\_droplet
     8  
     9  Provides a DigitalOcean droplet resource. This can be used to create,
    10  modify, and delete droplets. Droplets also support
    11  [provisioning](/docs/provisioners/index.html).
    12  
    13  ## Example Usage
    14  
    15  ```
    16  # Create a new Web droplet in the nyc2 region
    17  resource "digitalocean_droplet" "web" {
    18      image = "ubuntu-14-04-x64"
    19      name = "web-1"
    20      region = "nyc2"
    21      size = "512mb"
    22  }
    23  ```
    24  
    25  ## Argument Reference
    26  
    27  The following arguments are supported:
    28  
    29  * `image` - (Required) The droplet image ID or slug.
    30  * `name` - (Required) The droplet name
    31  * `region` - (Required) The region to start in
    32  * `size` - (Required) The instance size to start
    33  * `backups` - (Optional) Boolean controlling if backups are made.
    34  * `ipv6` - (Optional) Boolean controlling if IPv6 is enabled.
    35  * `private_networking` - (Optional) Boolean controlling if private networks are enabled.
    36  * `ssh_keys` - (Optional) A list of SSH IDs or fingerprints to enable in
    37     the format `[12345, 123456]`. To retrieve this info, use a tool such
    38     as `curl` with the [DigitalOcean API](https://developers.digitalocean.com/#keys),
    39     to retrieve them.
    40  * `user_data` (Optional) - A string of the desired User Data for the Droplet.
    41     User Data is currently only available in regions with metadata
    42     listed in their features.
    43  
    44  ## Attributes Reference
    45  
    46  The following attributes are exported:
    47  
    48  * `id` - The ID of the droplet
    49  * `name`- The name of the droplet
    50  * `region` - The region of the droplet
    51  * `image` - The image of the droplet
    52  * `ipv6` - Is IPv6 enabled
    53  * `ipv6_address` - The IPv6 address
    54  * `ipv6_address_private` - The private networking IPv6 address
    55  * `ipv4_address` - The IPv4 address
    56  * `ipv4_address_private` - The private networking IPv4 address
    57  * `locked` - Is the Droplet locked
    58  * `private_networking` - Is private networking enabled
    59  * `size` - The instance size
    60  * `status` - The status of the droplet
    61