Skip to main content

openstack_lb_monitor_v2

Last update:
For your information

These instructions are a copy of the official OpenStack Terraform provider documentation in the Terraform Registry.

Manages a V2 monitor resource within OpenStack.

Example Usage

resource "openstack_lb_monitor_v2" "monitor_1" {
  pool_id     = openstack_lb_pool_v2.pool_1.id
  type        = "PING"
  delay       = 20
  timeout     = 10
  max_retries = 5
}

Argument Reference

The following arguments are supported:

  • region - (Optional) The region in which to obtain the V2 Networking client. A Networking client is needed to create an . If omitted, the region argument of the provider is used. Changing this creates a newmonitor.

  • pool_id - (Required) The id of the pool that this monitor will be assigned to.

  • name - (Optional) The Name of the Monitor.

  • tenant_id - (Optional) Required for admins. The UUID of the tenant who ownssthe monitor.Only administrative users can specify a tenant UUIDother than their own. Changing this creates a new monitor.

  • type - (Required) The type of probe, which is PING, TCP, HTTP, HTTPS,TLS-HELLO or UDP-CONNECT (supported only in Octavia), that is sent by the loadbalancer to verify the member state. Changing this creates a new monitor.

  • delay - (Required) The time, in seconds, between sending probes to members.

  • timeout - (Required) Maximum number of seconds for a monitor to wait for aping reply before it times out. The value must be less than the delayvalue.

  • max_retries - (Required) Number of permissible ping failures beforechanging the member's status to INACTIVE. Must be a number between 1and 10.

  • max_retries_down - (Optional) Number of permissible ping failures befor changing the member'sstatus to ERROR. Must be a number between 1 and 10 (supported only in Octavia). Changing this updates the max_retries_down of the existing monitor.

  • url_path - (Optional) Required for HTTP(S) types. URI path that will beaccessed if monitor type is HTTP or HTTPS.

  • http_method - (Optional) Required for HTTP(S) types. The HTTP method usedfor requests by the monitor. If this attribute is not specified, itdefaults to "GET".

  • expected_codes - (Optional) Required for HTTP(S) types. Expected HTTP codesfor a passing HTTP(S) monitor. You can either specify a single status like "200", or a range like "200-202".

  • admin_state_up - (Optional) The administrative state of the monitor. A valid value is true (UP) or false (DOWN).

Attributes Reference

The following attributes are exported:

  • id - The unique ID for the monitor.
  • tenant_id - See Argument Reference above.
  • type - See Argument Reference above.
  • delay - See Argument Reference above.
  • timeout - See Argument Reference above.
  • max_retries - See Argument Reference above.
  • max_retries_down - See Argument Reference above.
  • url_path - See Argument Reference above.
  • http_method - See Argument Reference above.
  • expected_codes - See Argument Reference above.
  • admin_state_up - See Argument Reference above.

Import

Load Balancer Pool Monitor can be imported using the Monitor ID, e.g.:

$ terraform import openstack_lb_monitor_v2.monitor_1 47c26fc3-2403-427a-8c79-1589bd0533c2

In case of using OpenContrail, the import may not work properly. If you face an issue, try to import the monitor providing its parent pool ID:

$ terraform import openstack_lb_monitor_v2.monitor_1 47c26fc3-2403-427a-8c79-1589bd0533c2/708bc224-0f8c-4981-ac82-97095fe051b6