github.com/adrian-bl/terraform@v0.7.0-rc2.0.20160705220747-de0a34fc3517/website/source/docs/providers/openstack/r/lb_pool_v2.html.markdown (about)

     1  ---
     2  layout: "openstack"
     3  page_title: "OpenStack: openstack_lbaas_pool_v2"
     4  sidebar_current: "docs-openstack-resource-lbaas-pool-v2"
     5  description: |-
     6    Manages a V2 pool resource within OpenStack.
     7  ---
     8  
     9  # openstack\_lbaas\_pool\_v2
    10  
    11  Manages a V2 pool resource within OpenStack.
    12  
    13  ## Example Usage
    14  
    15  ```
    16  resource "openstack_lbaas_pool_v2" "pool_1" {
    17    protocol = "ProtocolHTTP"
    18    lb_method = "LBMethodRoundRobin"
    19    listener_id =  "d9415786-5f1a-428b-b35f-2f1523e146d2"
    20    persistence {
    21        type          = "HTTP_COOKIE"
    22        cookie_name   = "testCookie"
    23    }
    24  }
    25  ```
    26  
    27  ## Argument Reference
    28  
    29  The following arguments are supported:
    30  
    31  * `region` - (Required) The region in which to obtain the V2 Networking client.
    32      A Networking client is needed to create an . If omitted, the
    33      `OS_REGION_NAME` environment variable is used. Changing this creates a new
    34      pool.
    35  
    36  * `tenant_id` - (Optional) Required for admins. The UUID of the tenant who owns
    37      the pool.  Only administrative users can specify a tenant UUID
    38      other than their own. Changing this creates a new pool.
    39  
    40  * `name` - (Optional) Human-readable name for the pool.
    41  
    42  * `description` - (Optional) Human-readable description for the pool.
    43  
    44  * `protocol` = (Required) The protocol - can either be TCP, HTTP or HTTPS. 
    45      Changing this creates a new pool.
    46  
    47  * `loadbalancer_id` - (Optional) The load balancer on which to provision this
    48      pool. Changing this creates a new pool.
    49      Note:  One of LoadbalancerID or ListenerID must be provided.
    50  
    51  * `listener_id` - (Optional) The Listener on which the members of the pool
    52      will be associated with. Changing this creates a new pool.
    53  	Note:  One of LoadbalancerID or ListenerID must be provided.
    54  
    55  * `lb_method` - (Required) The algorithm used to distribute load between the
    56      members of the pool. The current specification supports
    57      LBMethodRoundRobin, LBMethodLeastConnections and LBMethodSourceIp as valid
    58      values for this attribute.
    59  
    60  * `persistence` - Omit this field to prevent session persistence.  Indicates
    61      whether connections in the same session will be processed by the same Pool
    62      member or not. Changing this creates a new pool.
    63  
    64  * `admin_state_up` - (Optional) The administrative state of the pool.
    65      A valid value is true (UP) or false (DOWN).
    66      
    67  The `persistence` argument supports:
    68  
    69  * `type` - (Required) The type of persistence mode. The current specification
    70      supports SOURCE_IP, HTTP_COOKIE, and APP_COOKIE.
    71  
    72  * `cookie_name` - (Required) The name of the cookie if persistence mode is set
    73      appropriately.
    74  
    75  ## Attributes Reference
    76  
    77  The following attributes are exported:
    78  
    79  * `id` - The unique ID for the pool.
    80  * `tenant_id` - See Argument Reference above.
    81  * `name` - See Argument Reference above.
    82  * `description` - See Argument Reference above.
    83  * `protocol` - See Argument Reference above.
    84  * `lb_method` - See Argument Reference above.
    85  * `persistence` - See Argument Reference above.
    86  * `admin_state_up` - See Argument Reference above.