|
1 | 1 | --- |
2 | 2 | # generated by https://github.com/hashicorp/terraform-plugin-docs |
3 | | -page_title: "stackit_alb Resource - stackit" |
| 3 | +page_title: "stackit_application_load_balancer Resource - stackit" |
4 | 4 | subcategory: "" |
5 | 5 | description: |- |
6 | 6 | Setting up supporting infrastructure |
7 | 7 | The example below creates the supporting infrastructure using the STACKIT Terraform provider, including the network, network interface, a public IP address and server resources. |
8 | 8 | --- |
9 | 9 |
|
10 | | -# stackit_alb (Resource) |
| 10 | +# stackit_application_load_balancer (Resource) |
11 | 11 |
|
12 | 12 | ## Setting up supporting infrastructure |
13 | 13 |
|
@@ -116,7 +116,7 @@ resource "stackit_loadbalancer_observability_credential" "observability" { |
116 | 116 | } |
117 | 117 |
|
118 | 118 | # Create a Application Load Balancer |
119 | | -resource "stackit_alb" "example" { |
| 119 | +resource "stackit_application_load_balancer" "example" { |
120 | 120 | project_id = var.project_id |
121 | 121 | region = "eu01" |
122 | 122 | name = "example-load-balancer" |
@@ -238,15 +238,14 @@ resource "stackit_alb" "example" { |
238 | 238 | - `external_address` (String) The external IP address where this Application Load Balancer is exposed. Not changeable after creation. |
239 | 239 | - `labels` (Map of String) Labels represent user-defined metadata as key-value pairs. Label count cannot exceed 64 per ALB. |
240 | 240 | - `options` (Attributes) Defines any optional functionality you want to have enabled on your Application Load Balancer. (see [below for nested schema](#nestedatt--options)) |
241 | | -- `region` (String) The resource region. If not defined, the provider region is used. Possible values are: `eu01`, `eu02`. |
| 241 | +- `region` (String) The resource region (e.g. eu01). If not defined, the provider region is used. |
242 | 242 |
|
243 | 243 | ### Read-Only |
244 | 244 |
|
245 | 245 | - `errors` (Attributes Set) Reports all errors a Application Load Balancer has. (see [below for nested schema](#nestedatt--errors)) |
246 | | -- `id` (String) Terraform's internal resource ID. It is structured as "`project_id`","region","`name`". |
| 246 | +- `id` (String) Terraform's internal resource ID. It is structured as `project_id`,`region`,`name`. |
247 | 247 | - `load_balancer_security_group` (Attributes) Security Group permitting network traffic from the LoadBalancer to the targets. Useful when disableTargetSecurityGroupAssignment=true to manually assign target security groups to targets. (see [below for nested schema](#nestedatt--load_balancer_security_group)) |
248 | 248 | - `private_address` (String) |
249 | | -- `status` (String) Enum: "STATUS_UNSPECIFIED" "STATUS_PENDING" "STATUS_READY" "STATUS_ERROR" "STATUS_TERMINATING" |
250 | 249 | - `target_security_group` (Attributes) Security Group that allows the targets to receive traffic from the LoadBalancer. Useful when disableTargetSecurityGroupAssignment=true to manually assign target security groups to targets. (see [below for nested schema](#nestedatt--target_security_group)) |
251 | 250 | - `version` (String) Application Load Balancer resource version. Used for concurrency safe updates. |
252 | 251 |
|
@@ -436,11 +435,19 @@ Optional: |
436 | 435 |
|
437 | 436 | Optional: |
438 | 437 |
|
439 | | -- `acl` (Set of String) Use this option to limit the IP ranges that can use the Application Load Balancer. |
| 438 | +- `access_control` (Attributes) Use this option to limit the IP ranges that can use the Application Load Balancer. (see [below for nested schema](#nestedatt--options--access_control)) |
440 | 439 | - `ephemeral_address` (Boolean) This option automates the handling of the external IP address for an Application Load Balancer. If set to true a new IP address will be automatically created. It will also be automatically deleted when the Load Balancer is deleted. |
441 | 440 | - `observability` (Attributes) We offer Load Balancer observability via STACKIT Observability or external solutions. (see [below for nested schema](#nestedatt--options--observability)) |
442 | 441 | - `private_network_only` (Boolean) Application Load Balancer is accessible only via a private network ip address. Not changeable after creation. |
443 | 442 |
|
| 443 | +<a id="nestedatt--options--access_control"></a> |
| 444 | +### Nested Schema for `options.access_control` |
| 445 | + |
| 446 | +Required: |
| 447 | + |
| 448 | +- `allowed_source_ranges` (Set of String) Application Load Balancer is accessible only from an IP address in this range. |
| 449 | + |
| 450 | + |
444 | 451 | <a id="nestedatt--options--observability"></a> |
445 | 452 | ### Nested Schema for `options.observability` |
446 | 453 |
|
@@ -475,7 +482,7 @@ Required: |
475 | 482 | Read-Only: |
476 | 483 |
|
477 | 484 | - `description` (String) The error description contains additional helpful user information to fix the error state of the Application Load Balancer. For example the IP 45.135.247.139 does not exist in the project, then the description will report: Floating IP "45.135.247.139" could not be found. |
478 | | -- `type` (String) Enum: "TYPE_UNSPECIFIED" "TYPE_INTERNAL" "TYPE_QUOTA_SECGROUP_EXCEEDED" "TYPE_QUOTA_SECGROUPRULE_EXCEEDED" "TYPE_PORT_NOT_CONFIGURED" "TYPE_FIP_NOT_CONFIGURED" "TYPE_TARGET_NOT_ACTIVE" "TYPE_METRICS_MISCONFIGURED" "TYPE_LOGS_MISCONFIGURED" |
| 485 | +- `type` (String) Enum: Possible values are: `TYPE_UNSPECIFIED`, `TYPE_INTERNAL`, `TYPE_QUOTA_SECGROUP_EXCEEDED`, `TYPE_QUOTA_SECGROUPRULE_EXCEEDED`, `TYPE_PORT_NOT_CONFIGURED`, `TYPE_FIP_NOT_CONFIGURED`, `TYPE_TARGET_NOT_ACTIVE`, `TYPE_METRICS_MISCONFIGURED`, `TYPE_LOGS_MISCONFIGURED`. |
479 | 486 | The error type specifies which part of the Application Load Balancer encountered the error. I.e. the API will not check if a provided public IP is actually available in the project. Instead the Application Load Balancer with try to use the provided IP and if not available reports TYPE_FIP_NOT_CONFIGURED error. |
480 | 487 |
|
481 | 488 |
|
|
0 commit comments