ionoscloud 6.7.6, Apr 14 25

ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud

ionos-cloud/terraform-provider-ionoscloud

ionoscloud.getApplicationLoadbalancer

Explore with Pulumi AI

ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud

ionos-cloud/terraform-provider-ionoscloud

The Application Load Balancer data source can be used to search for and return an existing Application Load Balancer. You can provide a string for the name parameter which will be compared with provisioned Application Load Balancers. If a single match is found, it will be returned. If your search results in multiple matches, an error will be returned. When this happens, please refine your search and make sure that your resources have unique names.

Example Usage

By Id

import * as pulumi from "@pulumi/pulumi";
import * as ionoscloud from "@pulumi/ionoscloud";

const example = ionoscloud.getApplicationLoadbalancer({
    datacenterId: ionoscloud_datacenter.example.id,
    id: "alb_id",
});

import pulumi
import pulumi_ionoscloud as ionoscloud

example = ionoscloud.get_application_loadbalancer(datacenter_id=ionoscloud_datacenter["example"]["id"],
    id="alb_id")

package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ionoscloud/v6/ionoscloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ionoscloud.LookupApplicationLoadbalancer(ctx, &ionoscloud.LookupApplicationLoadbalancerArgs{
			DatacenterId: ionoscloud_datacenter.Example.Id,
			Id:           pulumi.StringRef("alb_id"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ionoscloud = Pulumi.Ionoscloud;

return await Deployment.RunAsync(() => 
{
    var example = Ionoscloud.GetApplicationLoadbalancer.Invoke(new()
    {
        DatacenterId = ionoscloud_datacenter.Example.Id,
        Id = "alb_id",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ionoscloud.IonoscloudFunctions;
import com.pulumi.ionoscloud.inputs.GetApplicationLoadbalancerArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var example = IonoscloudFunctions.getApplicationLoadbalancer(GetApplicationLoadbalancerArgs.builder()
            .datacenterId(ionoscloud_datacenter.example().id())
            .id("alb_id")
            .build());

    }
}

variables:
  example:
    fn::invoke:
      function: ionoscloud:getApplicationLoadbalancer
      arguments:
        datacenterId: ${ionoscloud_datacenter.example.id}
        id: alb_id

By Name

import * as pulumi from "@pulumi/pulumi";
import * as ionoscloud from "@pulumi/ionoscloud";

const example = ionoscloud.getApplicationLoadbalancer({
    datacenterId: ionoscloud_datacenter.example.id,
    name: "ALB name",
});

import pulumi
import pulumi_ionoscloud as ionoscloud

example = ionoscloud.get_application_loadbalancer(datacenter_id=ionoscloud_datacenter["example"]["id"],
    name="ALB name")

package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ionoscloud/v6/ionoscloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ionoscloud.LookupApplicationLoadbalancer(ctx, &ionoscloud.LookupApplicationLoadbalancerArgs{
			DatacenterId: ionoscloud_datacenter.Example.Id,
			Name:         pulumi.StringRef("ALB name"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ionoscloud = Pulumi.Ionoscloud;

return await Deployment.RunAsync(() => 
{
    var example = Ionoscloud.GetApplicationLoadbalancer.Invoke(new()
    {
        DatacenterId = ionoscloud_datacenter.Example.Id,
        Name = "ALB name",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ionoscloud.IonoscloudFunctions;
import com.pulumi.ionoscloud.inputs.GetApplicationLoadbalancerArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var example = IonoscloudFunctions.getApplicationLoadbalancer(GetApplicationLoadbalancerArgs.builder()
            .datacenterId(ionoscloud_datacenter.example().id())
            .name("ALB name")
            .build());

    }
}

variables:
  example:
    fn::invoke:
      function: ionoscloud:getApplicationLoadbalancer
      arguments:
        datacenterId: ${ionoscloud_datacenter.example.id}
        name: ALB name

By Name with Partial Match

import * as pulumi from "@pulumi/pulumi";
import * as ionoscloud from "@pulumi/ionoscloud";

const example = ionoscloud.getApplicationLoadbalancer({
    datacenterId: ionoscloud_datacenter.example.id,
    name: "name",
    partialMatch: true,
});

import pulumi
import pulumi_ionoscloud as ionoscloud

example = ionoscloud.get_application_loadbalancer(datacenter_id=ionoscloud_datacenter["example"]["id"],
    name="name",
    partial_match=True)

package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ionoscloud/v6/ionoscloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ionoscloud.LookupApplicationLoadbalancer(ctx, &ionoscloud.LookupApplicationLoadbalancerArgs{
			DatacenterId: ionoscloud_datacenter.Example.Id,
			Name:         pulumi.StringRef("name"),
			PartialMatch: pulumi.BoolRef(true),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ionoscloud = Pulumi.Ionoscloud;

return await Deployment.RunAsync(() => 
{
    var example = Ionoscloud.GetApplicationLoadbalancer.Invoke(new()
    {
        DatacenterId = ionoscloud_datacenter.Example.Id,
        Name = "name",
        PartialMatch = true,
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ionoscloud.IonoscloudFunctions;
import com.pulumi.ionoscloud.inputs.GetApplicationLoadbalancerArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var example = IonoscloudFunctions.getApplicationLoadbalancer(GetApplicationLoadbalancerArgs.builder()
            .datacenterId(ionoscloud_datacenter.example().id())
            .name("name")
            .partialMatch(true)
            .build());

    }
}

variables:
  example:
    fn::invoke:
      function: ionoscloud:getApplicationLoadbalancer
      arguments:
        datacenterId: ${ionoscloud_datacenter.example.id}
        name: name
        partialMatch: true

Using getApplicationLoadbalancer

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getApplicationLoadbalancer(args: GetApplicationLoadbalancerArgs, opts?: InvokeOptions): Promise<GetApplicationLoadbalancerResult>
function getApplicationLoadbalancerOutput(args: GetApplicationLoadbalancerOutputArgs, opts?: InvokeOptions): Output<GetApplicationLoadbalancerResult>

def get_application_loadbalancer(datacenter_id: Optional[str] = None,
                                 id: Optional[str] = None,
                                 name: Optional[str] = None,
                                 partial_match: Optional[bool] = None,
                                 timeouts: Optional[GetApplicationLoadbalancerTimeouts] = None,
                                 opts: Optional[InvokeOptions] = None) -> GetApplicationLoadbalancerResult
def get_application_loadbalancer_output(datacenter_id: Optional[pulumi.Input[str]] = None,
                                 id: Optional[pulumi.Input[str]] = None,
                                 name: Optional[pulumi.Input[str]] = None,
                                 partial_match: Optional[pulumi.Input[bool]] = None,
                                 timeouts: Optional[pulumi.Input[GetApplicationLoadbalancerTimeoutsArgs]] = None,
                                 opts: Optional[InvokeOptions] = None) -> Output[GetApplicationLoadbalancerResult]

func LookupApplicationLoadbalancer(ctx *Context, args *LookupApplicationLoadbalancerArgs, opts ...InvokeOption) (*LookupApplicationLoadbalancerResult, error)
func LookupApplicationLoadbalancerOutput(ctx *Context, args *LookupApplicationLoadbalancerOutputArgs, opts ...InvokeOption) LookupApplicationLoadbalancerResultOutput

> Note: This function is named LookupApplicationLoadbalancer in the Go SDK.

public static class GetApplicationLoadbalancer 
{
    public static Task<GetApplicationLoadbalancerResult> InvokeAsync(GetApplicationLoadbalancerArgs args, InvokeOptions? opts = null)
    public static Output<GetApplicationLoadbalancerResult> Invoke(GetApplicationLoadbalancerInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetApplicationLoadbalancerResult> getApplicationLoadbalancer(GetApplicationLoadbalancerArgs args, InvokeOptions options)
public static Output<GetApplicationLoadbalancerResult> getApplicationLoadbalancer(GetApplicationLoadbalancerArgs args, InvokeOptions options)

fn::invoke:
  function: ionoscloud:index/getApplicationLoadbalancer:getApplicationLoadbalancer
  arguments:
    # arguments dictionary

The following arguments are supported:

DatacenterId string

Datacenter's UUID.

Id string

ID of the application load balancer you want to search for.

Name string

Name of an existing application load balancer that you want to search for. Search by name is case-insensitive. The whole resource name is required if partial_match parameter is not set to true.

PartialMatch bool

Whether partial matching is allowed or not when using name argument. Default value is false.

datacenter_id and either name or id must be provided. If none, or both of name and id are provided, the datasource will return an error.

Timeouts GetApplicationLoadbalancerTimeouts

DatacenterId string

Datacenter's UUID.

Id string

ID of the application load balancer you want to search for.

Name string

Name of an existing application load balancer that you want to search for. Search by name is case-insensitive. The whole resource name is required if partial_match parameter is not set to true.

PartialMatch bool

Whether partial matching is allowed or not when using name argument. Default value is false.

datacenter_id and either name or id must be provided. If none, or both of name and id are provided, the datasource will return an error.

Timeouts GetApplicationLoadbalancerTimeouts

datacenterId String

Datacenter's UUID.

id String

ID of the application load balancer you want to search for.

name String

Name of an existing application load balancer that you want to search for. Search by name is case-insensitive. The whole resource name is required if partial_match parameter is not set to true.

partialMatch Boolean

Whether partial matching is allowed or not when using name argument. Default value is false.

datacenter_id and either name or id must be provided. If none, or both of name and id are provided, the datasource will return an error.

timeouts GetApplicationLoadbalancerTimeouts

datacenterId string

Datacenter's UUID.

id string

ID of the application load balancer you want to search for.

name string

Name of an existing application load balancer that you want to search for. Search by name is case-insensitive. The whole resource name is required if partial_match parameter is not set to true.

partialMatch boolean

Whether partial matching is allowed or not when using name argument. Default value is false.

datacenter_id and either name or id must be provided. If none, or both of name and id are provided, the datasource will return an error.

timeouts GetApplicationLoadbalancerTimeouts

datacenter_id str

Datacenter's UUID.

id str

ID of the application load balancer you want to search for.

name str

Name of an existing application load balancer that you want to search for. Search by name is case-insensitive. The whole resource name is required if partial_match parameter is not set to true.

partial_match bool

Whether partial matching is allowed or not when using name argument. Default value is false.

datacenter_id and either name or id must be provided. If none, or both of name and id are provided, the datasource will return an error.

timeouts GetApplicationLoadbalancerTimeouts

datacenterId String

Datacenter's UUID.

id String

ID of the application load balancer you want to search for.

name String

Name of an existing application load balancer that you want to search for. Search by name is case-insensitive. The whole resource name is required if partial_match parameter is not set to true.

partialMatch Boolean

Whether partial matching is allowed or not when using name argument. Default value is false.

datacenter_id and either name or id must be provided. If none, or both of name and id are provided, the datasource will return an error.

timeouts Property Map

getApplicationLoadbalancer Result

The following output properties are available:

CentralLogging bool: Turn logging on and off for this product. Default value is 'false'.
DatacenterId string
Flowlogs List<GetApplicationLoadbalancerFlowlog>: Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
Id string: Id of the application load balancer.
Ips List<string>: Collection of the Application Load Balancer IP addresses. (Inbound and outbound) IPs of the listenerLan are customer-reserved public IPs for the public Load Balancers, and private IPs for the private Load Balancers.
LbPrivateIps List<string>: Collection of private IP addresses with the subnet mask of the Application Load Balancer. IPs must contain valid a subnet mask. If no IP is provided, the system will generate an IP with /24 subnet.
ListenerLan double: ID of the listening (inbound) LAN.
LoggingFormat string
Name string: Specifies the name of the flow log.
TargetLan double: ID of the balanced private target LAN (outbound).
PartialMatch bool
Timeouts GetApplicationLoadbalancerTimeouts

CentralLogging bool: Turn logging on and off for this product. Default value is 'false'.
DatacenterId string
Flowlogs []GetApplicationLoadbalancerFlowlog: Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
Id string: Id of the application load balancer.
Ips []string: Collection of the Application Load Balancer IP addresses. (Inbound and outbound) IPs of the listenerLan are customer-reserved public IPs for the public Load Balancers, and private IPs for the private Load Balancers.
LbPrivateIps []string: Collection of private IP addresses with the subnet mask of the Application Load Balancer. IPs must contain valid a subnet mask. If no IP is provided, the system will generate an IP with /24 subnet.
ListenerLan float64: ID of the listening (inbound) LAN.
LoggingFormat string
Name string: Specifies the name of the flow log.
TargetLan float64: ID of the balanced private target LAN (outbound).
PartialMatch bool
Timeouts GetApplicationLoadbalancerTimeouts

centralLogging Boolean: Turn logging on and off for this product. Default value is 'false'.
datacenterId String
flowlogs List<GetApplicationLoadbalancerFlowlog>: Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
id String: Id of the application load balancer.
ips List<String>: Collection of the Application Load Balancer IP addresses. (Inbound and outbound) IPs of the listenerLan are customer-reserved public IPs for the public Load Balancers, and private IPs for the private Load Balancers.
lbPrivateIps List<String>: Collection of private IP addresses with the subnet mask of the Application Load Balancer. IPs must contain valid a subnet mask. If no IP is provided, the system will generate an IP with /24 subnet.
listenerLan Double: ID of the listening (inbound) LAN.
loggingFormat String
name String: Specifies the name of the flow log.
targetLan Double: ID of the balanced private target LAN (outbound).
partialMatch Boolean
timeouts GetApplicationLoadbalancerTimeouts

centralLogging boolean: Turn logging on and off for this product. Default value is 'false'.
datacenterId string
flowlogs GetApplicationLoadbalancerFlowlog[]: Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
id string: Id of the application load balancer.
ips string[]: Collection of the Application Load Balancer IP addresses. (Inbound and outbound) IPs of the listenerLan are customer-reserved public IPs for the public Load Balancers, and private IPs for the private Load Balancers.
lbPrivateIps string[]: Collection of private IP addresses with the subnet mask of the Application Load Balancer. IPs must contain valid a subnet mask. If no IP is provided, the system will generate an IP with /24 subnet.
listenerLan number: ID of the listening (inbound) LAN.
loggingFormat string
name string: Specifies the name of the flow log.
targetLan number: ID of the balanced private target LAN (outbound).
partialMatch boolean
timeouts GetApplicationLoadbalancerTimeouts

central_logging bool: Turn logging on and off for this product. Default value is 'false'.
datacenter_id str
flowlogs Sequence[GetApplicationLoadbalancerFlowlog]: Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
id str: Id of the application load balancer.
ips Sequence[str]: Collection of the Application Load Balancer IP addresses. (Inbound and outbound) IPs of the listenerLan are customer-reserved public IPs for the public Load Balancers, and private IPs for the private Load Balancers.
lb_private_ips Sequence[str]: Collection of private IP addresses with the subnet mask of the Application Load Balancer. IPs must contain valid a subnet mask. If no IP is provided, the system will generate an IP with /24 subnet.
listener_lan float: ID of the listening (inbound) LAN.
logging_format str
name str: Specifies the name of the flow log.
target_lan float: ID of the balanced private target LAN (outbound).
partial_match bool
timeouts GetApplicationLoadbalancerTimeouts

centralLogging Boolean: Turn logging on and off for this product. Default value is 'false'.
datacenterId String
flowlogs List<Property Map>: Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
id String: Id of the application load balancer.
ips List<String>: Collection of the Application Load Balancer IP addresses. (Inbound and outbound) IPs of the listenerLan are customer-reserved public IPs for the public Load Balancers, and private IPs for the private Load Balancers.
lbPrivateIps List<String>: Collection of private IP addresses with the subnet mask of the Application Load Balancer. IPs must contain valid a subnet mask. If no IP is provided, the system will generate an IP with /24 subnet.
listenerLan Number: ID of the listening (inbound) LAN.
loggingFormat String
name String: Specifies the name of the flow log.
targetLan Number: ID of the balanced private target LAN (outbound).
partialMatch Boolean
timeouts Property Map

Supporting Types

GetApplicationLoadbalancerFlowlog

Action string: Specifies the action to be taken when the rule is matched. Possible values: ACCEPTED, REJECTED, ALL. Immutable, forces re-creation.
Bucket string: Specifies the IONOS Object Storage bucket where the flow log data will be stored. The bucket must exist. Immutable, forces re-creation.
Direction string: Specifies the traffic direction pattern. Valid values: INGRESS, EGRESS, BIDIRECTIONAL. Immutable, forces re-creation.
Id string: ID of the application load balancer you want to search for.
Name string: Name of an existing application load balancer that you want to search for. Search by name is case-insensitive. The whole resource name is required if partial_match parameter is not set to true.

Action string: Specifies the action to be taken when the rule is matched. Possible values: ACCEPTED, REJECTED, ALL. Immutable, forces re-creation.
Bucket string: Specifies the IONOS Object Storage bucket where the flow log data will be stored. The bucket must exist. Immutable, forces re-creation.
Direction string: Specifies the traffic direction pattern. Valid values: INGRESS, EGRESS, BIDIRECTIONAL. Immutable, forces re-creation.
Id string: ID of the application load balancer you want to search for.
Name string: Name of an existing application load balancer that you want to search for. Search by name is case-insensitive. The whole resource name is required if partial_match parameter is not set to true.

action String: Specifies the action to be taken when the rule is matched. Possible values: ACCEPTED, REJECTED, ALL. Immutable, forces re-creation.
bucket String: Specifies the IONOS Object Storage bucket where the flow log data will be stored. The bucket must exist. Immutable, forces re-creation.
direction String: Specifies the traffic direction pattern. Valid values: INGRESS, EGRESS, BIDIRECTIONAL. Immutable, forces re-creation.
id String: ID of the application load balancer you want to search for.
name String: Name of an existing application load balancer that you want to search for. Search by name is case-insensitive. The whole resource name is required if partial_match parameter is not set to true.

action string: Specifies the action to be taken when the rule is matched. Possible values: ACCEPTED, REJECTED, ALL. Immutable, forces re-creation.
bucket string: Specifies the IONOS Object Storage bucket where the flow log data will be stored. The bucket must exist. Immutable, forces re-creation.
direction string: Specifies the traffic direction pattern. Valid values: INGRESS, EGRESS, BIDIRECTIONAL. Immutable, forces re-creation.
id string: ID of the application load balancer you want to search for.
name string: Name of an existing application load balancer that you want to search for. Search by name is case-insensitive. The whole resource name is required if partial_match parameter is not set to true.

action str: Specifies the action to be taken when the rule is matched. Possible values: ACCEPTED, REJECTED, ALL. Immutable, forces re-creation.
bucket str: Specifies the IONOS Object Storage bucket where the flow log data will be stored. The bucket must exist. Immutable, forces re-creation.
direction str: Specifies the traffic direction pattern. Valid values: INGRESS, EGRESS, BIDIRECTIONAL. Immutable, forces re-creation.
id str: ID of the application load balancer you want to search for.
name str: Name of an existing application load balancer that you want to search for. Search by name is case-insensitive. The whole resource name is required if partial_match parameter is not set to true.

action String: Specifies the action to be taken when the rule is matched. Possible values: ACCEPTED, REJECTED, ALL. Immutable, forces re-creation.
bucket String: Specifies the IONOS Object Storage bucket where the flow log data will be stored. The bucket must exist. Immutable, forces re-creation.
direction String: Specifies the traffic direction pattern. Valid values: INGRESS, EGRESS, BIDIRECTIONAL. Immutable, forces re-creation.
id String: ID of the application load balancer you want to search for.
name String: Name of an existing application load balancer that you want to search for. Search by name is case-insensitive. The whole resource name is required if partial_match parameter is not set to true.

GetApplicationLoadbalancerTimeouts

Create string
Default string
Delete string
Update string

Create string
Default string
Delete string
Update string

create String
default_ String
delete String
update String

create string
default string
delete string
update string

create str
default str
delete str
update str

create String
default String
delete String
update String

Package Details

Repository: ionoscloud ionos-cloud/terraform-provider-ionoscloud
License
Notes: This Pulumi package is based on the ionoscloud Terraform Provider.

ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud

ionos-cloud/terraform-provider-ionoscloud

ionoscloud.getApplicationLoadbalancer

On this page

On this page

Example Usage

By Id

By Name

By Name with Partial Match

Using getApplicationLoadbalancer

getApplicationLoadbalancer Result

Supporting Types

GetApplicationLoadbalancerFlowlog

GetApplicationLoadbalancerTimeouts

Package Details

On this page

On this page