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