github.com/atsaki/terraform@v0.4.3-0.20150919165407-25bba5967654/website/source/docs/providers/openstack/r/lb_pool_v1.html.markdown (about)

     1  ---
     2  layout: "openstack"
     3  page_title: "OpenStack: openstack_lb_pool_v1"
     4  sidebar_current: "docs-openstack-resource-lb-pool-v1"
     5  description: |-
     6    Manages a V1 load balancer pool resource within OpenStack.
     7  ---
     8  
     9  # openstack\_lb\_pool_v1
    10  
    11  Manages a V1 load balancer pool resource within OpenStack.
    12  
    13  ## Example Usage
    14  
    15  ```
    16  resource "openstack_lb_pool_v1" "pool_1" {
    17    name = "tf_test_lb_pool"
    18    protocol = "HTTP"
    19    subnet_id = "12345"
    20    lb_method = "ROUND_ROBIN"
    21    monitor_ids = ["67890"]
    22    member {
    23      address = "192.168.0.1"
    24      port = 80
    25      admin_state_up = "true"
    26    }
    27  }
    28  ```
    29  
    30  ## Argument Reference
    31  
    32  The following arguments are supported:
    33  
    34  * `region` - (Required) The region in which to obtain the V2 Networking client.
    35      A Networking client is needed to create an LB pool. If omitted, the
    36      `OS_REGION_NAME` environment variable is used. Changing this creates a new
    37      LB pool.
    38  
    39  * `name` - (Required) The name of the pool. Changing this updates the name of
    40      the existing pool.
    41  
    42  * `protocol` - (Required)  The protocol used by the pool members, you can use
    43    either 'TCP, 'HTTP', or 'HTTPS'. Changing this creates a new pool.
    44  
    45  * `subnet_id` - (Required) The network on which the members of the pool will be
    46      located. Only members that are on this network can be added to the pool.
    47      Changing this creates a new pool.
    48  
    49  * `lb_method` - (Required) The algorithm used to distribute load between the
    50      members of the pool. The current specification supports 'ROUND_ROBIN' and
    51      'LEAST_CONNECTIONS' as valid values for this attribute.
    52  
    53  * `tenant_id` - (Optional) The owner of the pool. Required if admin wants to
    54      create a pool member for another tenant. Changing this creates a new pool.
    55  
    56  * `monitor_ids` - (Optional) A list of IDs of monitors to associate with the
    57      pool.
    58  
    59  * `member` - (Optional) An existing node to add to the pool. Changing this
    60      updates the members of the pool. The member object structure is documented
    61      below.
    62  
    63  The `member` block supports:
    64  
    65  * `address` - (Required) The IP address of the member. Changing this creates a
    66  new member.
    67  
    68  * `port` - (Required) An integer representing the port on which the member is
    69  hosted. Changing this creates a new member.
    70  
    71  * `admin_state_up` - (Optional) The administrative state of the member.
    72  Acceptable values are 'true' and 'false'. Changing this value updates the
    73  state of the existing member.
    74  
    75  * `tenant_id` - (Optional) The owner of the member. Required if admin wants to
    76  create a pool member for another tenant. Changing this creates a new member.
    77  
    78  
    79  ## Attributes Reference
    80  
    81  The following attributes are exported:
    82  
    83  * `region` - See Argument Reference above.
    84  * `name` - See Argument Reference above.
    85  * `protocol` - See Argument Reference above.
    86  * `subnet_id` - See Argument Reference above.
    87  * `lb_method` - See Argument Reference above.
    88  * `tenant_id` - See Argument Reference above.
    89  * `monitor_id` - See Argument Reference above.
    90  * `member` - See Argument Reference above.