github.com/turtlemonvh/terraform@v0.6.9-0.20151204001754-8e40b6b855e8/website/source/docs/providers/do/r/floating_ip.html.markdown (about)

     1  ---
     2  layout: "digitalocean"
     3  page_title: "DigitalOcean: digitalocean_floating_ip"
     4  sidebar_current: "docs-do-resource-floating-ip"
     5  description: |-
     6    Provides a DigitalOcean Floating IP resource.
     7  ---
     8  
     9  # digitalocean\_floating_ip
    10  
    11  Provides a DigitalOcean Floating IP to represent a publicly-accessible static IP addresses that can be mapped to one of your Droplets.
    12  
    13  ## Example Usage
    14  
    15  ```
    16  resource "digitalocean_droplet" "foobar" {
    17      name = "baz"
    18      size = "1gb"
    19      image = "centos-5-8-x32"
    20      region = "sgp1"
    21      ipv6 = true
    22      private_networking = true
    23  }
    24  
    25  resource "digitalocean_floating_ip" "foobar" {
    26      droplet_id = "${digitalocean_droplet.foobar.id}"
    27      region = "${digitalocean_droplet.foobar.region}"
    28  }
    29  ```
    30  
    31  ## Argument Reference
    32  
    33  The following arguments are supported:
    34  
    35  * `region` - (Required) The region that the Floating IP is reserved to.
    36  * `droplet_id` - (Optional) The ID of Droplet that the Floating IP will be assigned to.
    37  
    38  ~> **NOTE:** A Floating IP can be assigned to a region OR a droplet_id. If both region AND droplet_id are specified, then the Floating IP will be assigned to the droplet and use that region
    39  
    40  ## Attributes Reference
    41  
    42  The following attributes are exported:
    43  
    44  * `ip_address` - The IP Address of the resource