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 a . 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