github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/openstack/r/networking_floatingip_v2.html.markdown (about)

     1  ---
     2  layout: "openstack"
     3  page_title: "OpenStack: openstack_networking_floatingip_v2"
     4  sidebar_current: "docs-openstack-resource-networking-floatingip-v2"
     5  description: |-
     6    Manages a V2 floating IP resource within OpenStack Neutron (networking).
     7  ---
     8  
     9  # openstack\_networking\_floatingip_v2
    10  
    11  Manages a V2 floating IP resource within OpenStack Neutron (networking)
    12  that can be used for load balancers.
    13  These are similar to Nova (compute) floating IP resources,
    14  but only compute floating IPs can be used with compute instances.
    15  
    16  ## Example Usage
    17  
    18  ```hcl
    19  resource "openstack_networking_floatingip_v2" "floatip_1" {
    20    pool = "public"
    21  }
    22  ```
    23  
    24  ## Argument Reference
    25  
    26  The following arguments are supported:
    27  
    28  * `region` - (Required) The region in which to obtain the V2 Networking client.
    29      A Networking client is needed to create a floating IP that can be used with
    30      another networking resource, such as a load balancer. If omitted, the
    31      `OS_REGION_NAME` environment variable is used. Changing this creates a new
    32      floating IP (which may or may not have a different address).
    33  
    34  * `pool` - (Required) The name of the pool from which to obtain the floating
    35      IP. Changing this creates a new floating IP.
    36  
    37  * `port_id` - (Optional) ID of an existing port with at least one IP address to
    38      associate with this floating IP.
    39  
    40  * `tenant_id` - (Optional) The target tenant ID in which to allocate the floating
    41      IP, if you specify this together with a port_id, make sure the target port
    42      belongs to the same tenant. Changing this creates a new floating IP (which
    43      may or may not have a different address)
    44  
    45  * `fixed_ip` - Fixed IP of the port to associate with this floating IP. Required if
    46  the port has multiple fixed IPs.
    47  
    48  * `value_specs` - (Optional) Map of additional options.
    49  
    50  ## Attributes Reference
    51  
    52  The following attributes are exported:
    53  
    54  * `region` - See Argument Reference above.
    55  * `pool` - See Argument Reference above.
    56  * `address` - The actual floating IP address itself.
    57  * `port_id` - ID of associated port.
    58  * `tenant_id` - the ID of the tenant in which to create the floating IP.
    59  * `fixed_ip` - The fixed IP which the floating IP maps to.
    60  
    61  ## Import
    62  
    63  Floating IPs can be imported using the `id`, e.g.
    64  
    65  ```
    66  $ terraform import openstack_networking_floatingip_v2.floatip_1 2c7f39f3-702b-48d1-940c-b50384177ee1
    67  ```