2014-07-24 16:29:42 +02:00
|
|
|
---
|
|
|
|
layout: "digitalocean"
|
|
|
|
page_title: "DigitalOcean: digitalocean_droplet"
|
|
|
|
sidebar_current: "docs-do-resource-droplet"
|
|
|
|
---
|
|
|
|
|
|
|
|
# digitalocean\_droplet
|
|
|
|
|
|
|
|
Provides a DigitalOcean droplet resource. This can be used to create,
|
|
|
|
modify, and delete droplets. Droplets also support
|
|
|
|
[provisioning](/docs/provisioners/index.html).
|
|
|
|
|
|
|
|
## Example Usage
|
|
|
|
|
|
|
|
```
|
|
|
|
# Create a new Web droplet in the nyc2 region
|
|
|
|
resource "digitalocean_droplet" "web" {
|
|
|
|
image = "ubuntu1404"
|
|
|
|
name = "web-1"
|
|
|
|
region = "nyc2"
|
|
|
|
size = "512mb"
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
## Argument Reference
|
|
|
|
|
|
|
|
The following arguments are supported:
|
|
|
|
|
|
|
|
* `image` - (Required) The droplet image ID or slug.
|
|
|
|
* `name` - (Required) The droplet name
|
|
|
|
* `region` - (Required) The region to start in
|
|
|
|
* `size` - (Required) The instance size to start
|
|
|
|
* `backups` - (Optional) Boolean controling if backups are made.
|
|
|
|
* `ipv6` - (Optional) Boolean controling if IPv6 is enabled.
|
|
|
|
* `private_networking` - (Optional) Boolean controling if private networks are enabled.
|
|
|
|
* `ssh_keys` - (Optional) A list of SSH IDs or fingerprints to enable.
|
|
|
|
|
|
|
|
## Attributes Reference
|
|
|
|
|
|
|
|
The following attributes are exported:
|
|
|
|
|
|
|
|
* `id` - The ID of the droplet
|
|
|
|
* `name`- The name of the droplet
|
|
|
|
* `region` - The region of the droplet
|
|
|
|
* `image` - The image of the droplet
|
|
|
|
* `ipv6` - Is IPv6 enabled
|
|
|
|
* `ipv6_address` - The IPv6 address
|
|
|
|
* `ipv4_address` - The IPv4 address
|
2014-07-28 19:04:17 +02:00
|
|
|
* `locked` - Is the Droplet locked
|
2014-07-24 16:29:42 +02:00
|
|
|
* `private_networking` - Is private networking enabled
|
|
|
|
* `size` - The instance size
|
2014-07-28 19:04:17 +02:00
|
|
|
* `status` - The status of the droplet
|
2014-07-24 16:29:42 +02:00
|
|
|
|