github.com/minamijoyo/terraform@v0.7.8-0.20161029001309-18b3736ba44b/website/source/docs/providers/openstack/r/lb_pool_v2.html.markdown (about)

     1  ---
     2  layout: "openstack"
     3  page_title: "OpenStack: openstack_lb_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_lb_pool_v2" "pool_1" {
    17    protocol = "ProtocolHTTP"
    18    lb_method = "ROUND_ROBIN"
    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 load balancing algorithm to
    56      distribute traffic to the pool's members. Must be one of
    57      ROUND_ROBIN, LEAST_CONNECTIONS, or SOURCE_IP.
    58  
    59  * `persistence` - Omit this field to prevent session persistence.  Indicates
    60      whether connections in the same session will be processed by the same Pool
    61      member or not. Changing this creates a new pool.
    62  
    63  * `admin_state_up` - (Optional) The administrative state of the pool.
    64      A valid value is true (UP) or false (DOWN).
    65      
    66  The `persistence` argument supports:
    67  
    68  * `type` - (Required) The type of persistence mode. The current specification
    69      supports SOURCE_IP, HTTP_COOKIE, and APP_COOKIE.
    70  
    71  * `cookie_name` - (Required) The name of the cookie if persistence mode is set
    72      appropriately.
    73  
    74  ## Attributes Reference
    75  
    76  The following attributes are exported:
    77  
    78  * `id` - The unique ID for the pool.
    79  * `tenant_id` - See Argument Reference above.
    80  * `name` - See Argument Reference above.
    81  * `description` - See Argument Reference above.
    82  * `protocol` - See Argument Reference above.
    83  * `lb_method` - See Argument Reference above.
    84  * `persistence` - See Argument Reference above.
    85  * `admin_state_up` - See Argument Reference above.