terraform-provider-stackitp.../docs/data-sources/loadbalancer.md
Christian Hamm 04ce56b3d6
Increase the target count per pool from 250 to 1000 to be ready for large SKE clusters (#550)
Co-authored-by: Christian Hamm <Christian.Hamm@mail.schwarz>
2024-10-10 11:15:01 +01:00

4.6 KiB

page_title subcategory description
stackit_loadbalancer Data Source - stackit Load Balancer data source schema. Must have a region specified in the provider configuration.

stackit_loadbalancer (Data Source)

Load Balancer data source schema. Must have a region specified in the provider configuration.

Example Usage

data "stackit_loadbalancer" "example" {
  project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name       = "example-load-balancer"
}

Schema

Required

  • name (String) Load balancer name.
  • project_id (String) STACKIT project ID to which the Load Balancer is associated.

Read-Only

  • external_address (String) External Load Balancer IP address where this Load Balancer is exposed.
  • id (String) Terraform's internal resource ID. It is structured as "project_id","name".
  • listeners (Attributes List) List of all listeners which will accept traffic. Limited to 20. (see below for nested schema)
  • networks (Attributes List) List of networks that listeners and targets reside in. (see below for nested schema)
  • options (Attributes) Defines any optional functionality you want to have enabled on your load balancer. (see below for nested schema)
  • private_address (String) Transient private Load Balancer IP address. It can change any time.
  • target_pools (Attributes List) List of all target pools which will be used in the Load Balancer. Limited to 20. (see below for nested schema)

Nested Schema for listeners

Optional:

  • server_name_indicators (Attributes List) A list of domain names to match in order to pass TLS traffic to the target pool in the current listener (see below for nested schema)

Read-Only:

  • display_name (String)
  • port (Number) Port number where we listen for traffic.
  • protocol (String) Protocol is the highest network protocol we understand to load balance.
  • target_pool (String) Reference target pool by target pool name.

Nested Schema for listeners.server_name_indicators

Optional:

  • name (String) A domain name to match in order to pass TLS traffic to the target pool in the current listener

Nested Schema for networks

Read-Only:

  • network_id (String) Openstack network ID.
  • role (String) The role defines how the load balancer is using the network.

Nested Schema for options

Read-Only:

  • acl (Set of String) Load Balancer is accessible only from an IP address in this range.
  • private_network_only (Boolean) If true, Load Balancer is accessible only via a private network IP address.

Nested Schema for target_pools

Optional:

  • session_persistence (Attributes) Here you can setup various session persistence options, so far only "use_source_ip_address" is supported. (see below for nested schema)

Read-Only:

  • active_health_check (Attributes) (see below for nested schema)
  • name (String) Target pool name.
  • target_port (Number) Identical port number where each target listens for traffic.
  • targets (Attributes List) List of all targets which will be used in the pool. Limited to 1000. (see below for nested schema)

Nested Schema for target_pools.session_persistence

Optional:

  • use_source_ip_address (Boolean) If true then all connections from one source IP address are redirected to the same target. This setting changes the load balancing algorithm to Maglev.

Nested Schema for target_pools.active_health_check

Read-Only:

  • healthy_threshold (Number) Healthy threshold of the health checking.
  • interval (String) Interval duration of health checking in seconds.
  • interval_jitter (String) Interval duration threshold of the health checking in seconds.
  • timeout (String) Active health checking timeout duration in seconds.
  • unhealthy_threshold (Number) Unhealthy threshold of the health checking.

Nested Schema for target_pools.targets

Read-Only:

  • display_name (String) Target display name
  • ip (String) Target IP