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

Explore with Pulumi AI

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

ionos-cloud/terraform-provider-ionoscloud

The Network Load Balancer Forwarding Rule data source can be used to search for and return existing network forwarding rules. 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 string so that it is specific enough to return only one result.

By ID

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

const example = ionoscloud.getNetworkloadbalancerForwardingrule({
    datacenterId: "datacenter_id",
    id: "networkloadbalancer_forwardingrule_id",
    networkloadbalancerId: "networkloadbalancer_id",
});

import pulumi
import pulumi_ionoscloud as ionoscloud

example = ionoscloud.get_networkloadbalancer_forwardingrule(datacenter_id="datacenter_id",
    id="networkloadbalancer_forwardingrule_id",
    networkloadbalancer_id="networkloadbalancer_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.LookupNetworkloadbalancerForwardingrule(ctx, &ionoscloud.LookupNetworkloadbalancerForwardingruleArgs{
			DatacenterId:          "datacenter_id",
			Id:                    pulumi.StringRef("networkloadbalancer_forwardingrule_id"),
			NetworkloadbalancerId: "networkloadbalancer_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.GetNetworkloadbalancerForwardingrule.Invoke(new()
    {
        DatacenterId = "datacenter_id",
        Id = "networkloadbalancer_forwardingrule_id",
        NetworkloadbalancerId = "networkloadbalancer_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.GetNetworkloadbalancerForwardingruleArgs;
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.getNetworkloadbalancerForwardingrule(GetNetworkloadbalancerForwardingruleArgs.builder()
            .datacenterId("datacenter_id")
            .id("networkloadbalancer_forwardingrule_id")
            .networkloadbalancerId("networkloadbalancer_id")
            .build());

    }
}

variables:
  example:
    fn::invoke:
      function: ionoscloud:getNetworkloadbalancerForwardingrule
      arguments:
        datacenterId: datacenter_id
        id: networkloadbalancer_forwardingrule_id
        networkloadbalancerId: networkloadbalancer_id

By Name

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

const example = ionoscloud.getNetworkloadbalancerForwardingrule({
    datacenterId: "datacenter_id",
    name: "Network Load Balancer Forwarding Rule Example",
    networkloadbalancerId: "networkloadbalancer_id",
});

import pulumi
import pulumi_ionoscloud as ionoscloud

example = ionoscloud.get_networkloadbalancer_forwardingrule(datacenter_id="datacenter_id",
    name="Network Load Balancer Forwarding Rule Example",
    networkloadbalancer_id="networkloadbalancer_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.LookupNetworkloadbalancerForwardingrule(ctx, &ionoscloud.LookupNetworkloadbalancerForwardingruleArgs{
			DatacenterId:          "datacenter_id",
			Name:                  pulumi.StringRef("Network Load Balancer Forwarding Rule Example"),
			NetworkloadbalancerId: "networkloadbalancer_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.GetNetworkloadbalancerForwardingrule.Invoke(new()
    {
        DatacenterId = "datacenter_id",
        Name = "Network Load Balancer Forwarding Rule Example",
        NetworkloadbalancerId = "networkloadbalancer_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.GetNetworkloadbalancerForwardingruleArgs;
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.getNetworkloadbalancerForwardingrule(GetNetworkloadbalancerForwardingruleArgs.builder()
            .datacenterId("datacenter_id")
            .name("Network Load Balancer Forwarding Rule Example")
            .networkloadbalancerId("networkloadbalancer_id")
            .build());

    }
}

variables:
  example:
    fn::invoke:
      function: ionoscloud:getNetworkloadbalancerForwardingrule
      arguments:
        datacenterId: datacenter_id
        name: Network Load Balancer Forwarding Rule Example
        networkloadbalancerId: networkloadbalancer_id

Using getNetworkloadbalancerForwardingrule

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 getNetworkloadbalancerForwardingrule(args: GetNetworkloadbalancerForwardingruleArgs, opts?: InvokeOptions): Promise<GetNetworkloadbalancerForwardingruleResult>
function getNetworkloadbalancerForwardingruleOutput(args: GetNetworkloadbalancerForwardingruleOutputArgs, opts?: InvokeOptions): Output<GetNetworkloadbalancerForwardingruleResult>

def get_networkloadbalancer_forwardingrule(datacenter_id: Optional[str] = None,
                                           id: Optional[str] = None,
                                           name: Optional[str] = None,
                                           networkloadbalancer_id: Optional[str] = None,
                                           timeouts: Optional[GetNetworkloadbalancerForwardingruleTimeouts] = None,
                                           opts: Optional[InvokeOptions] = None) -> GetNetworkloadbalancerForwardingruleResult
def get_networkloadbalancer_forwardingrule_output(datacenter_id: Optional[pulumi.Input[str]] = None,
                                           id: Optional[pulumi.Input[str]] = None,
                                           name: Optional[pulumi.Input[str]] = None,
                                           networkloadbalancer_id: Optional[pulumi.Input[str]] = None,
                                           timeouts: Optional[pulumi.Input[GetNetworkloadbalancerForwardingruleTimeoutsArgs]] = None,
                                           opts: Optional[InvokeOptions] = None) -> Output[GetNetworkloadbalancerForwardingruleResult]

func LookupNetworkloadbalancerForwardingrule(ctx *Context, args *LookupNetworkloadbalancerForwardingruleArgs, opts ...InvokeOption) (*LookupNetworkloadbalancerForwardingruleResult, error)
func LookupNetworkloadbalancerForwardingruleOutput(ctx *Context, args *LookupNetworkloadbalancerForwardingruleOutputArgs, opts ...InvokeOption) LookupNetworkloadbalancerForwardingruleResultOutput

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

public static class GetNetworkloadbalancerForwardingrule 
{
    public static Task<GetNetworkloadbalancerForwardingruleResult> InvokeAsync(GetNetworkloadbalancerForwardingruleArgs args, InvokeOptions? opts = null)
    public static Output<GetNetworkloadbalancerForwardingruleResult> Invoke(GetNetworkloadbalancerForwardingruleInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetNetworkloadbalancerForwardingruleResult> getNetworkloadbalancerForwardingrule(GetNetworkloadbalancerForwardingruleArgs args, InvokeOptions options)
public static Output<GetNetworkloadbalancerForwardingruleResult> getNetworkloadbalancerForwardingrule(GetNetworkloadbalancerForwardingruleArgs args, InvokeOptions options)

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

The following arguments are supported:

DatacenterId string

Datacenter's UUID.

NetworkloadbalancerId string

Network Load Balancer's UUID.

Id string

ID of the network load balancer forwarding rule you want to search for.

Both datacenter_id and networkloadbalancer_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.

Name string

Name of an existing network load balancer forwarding rule that you want to search for.

Timeouts GetNetworkloadbalancerForwardingruleTimeouts

DatacenterId string

Datacenter's UUID.

NetworkloadbalancerId string

Network Load Balancer's UUID.

Id string

ID of the network load balancer forwarding rule you want to search for.

Both datacenter_id and networkloadbalancer_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.

Name string

Name of an existing network load balancer forwarding rule that you want to search for.

Timeouts GetNetworkloadbalancerForwardingruleTimeouts

datacenterId String

Datacenter's UUID.

networkloadbalancerId String

Network Load Balancer's UUID.

id String

ID of the network load balancer forwarding rule you want to search for.

Both datacenter_id and networkloadbalancer_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.

name String

Name of an existing network load balancer forwarding rule that you want to search for.

timeouts GetNetworkloadbalancerForwardingruleTimeouts

datacenterId string

Datacenter's UUID.

networkloadbalancerId string

Network Load Balancer's UUID.

id string

ID of the network load balancer forwarding rule you want to search for.

Both datacenter_id and networkloadbalancer_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.

name string

Name of an existing network load balancer forwarding rule that you want to search for.

timeouts GetNetworkloadbalancerForwardingruleTimeouts

datacenter_id str

Datacenter's UUID.

networkloadbalancer_id str

Network Load Balancer's UUID.

id str

ID of the network load balancer forwarding rule you want to search for.

Both datacenter_id and networkloadbalancer_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.

name str

Name of an existing network load balancer forwarding rule that you want to search for.

timeouts GetNetworkloadbalancerForwardingruleTimeouts

datacenterId String

Datacenter's UUID.

networkloadbalancerId String

Network Load Balancer's UUID.

id String

ID of the network load balancer forwarding rule you want to search for.

Both datacenter_id and networkloadbalancer_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.

name String

Name of an existing network load balancer forwarding rule that you want to search for.

timeouts Property Map

getNetworkloadbalancerForwardingrule Result

The following output properties are available:

Algorithm string: Algorithm for the balancing.
DatacenterId string
HealthChecks List<GetNetworkloadbalancerForwardingruleHealthCheck>: Health check attributes for Network Load Balancer forwarding rule target.
Id string: The id of that Network Load Balancer forwarding rule.
ListenerIp string: Listening IP. (inbound)
ListenerPort double: Listening port number. (inbound) (range: 1 to 65535)
Name string: The name of that Network Load Balancer forwarding rule.
NetworkloadbalancerId string
Protocol string: Protocol of the balancing.
Targets List<GetNetworkloadbalancerForwardingruleTarget>: Array of items in that collection.
Timeouts GetNetworkloadbalancerForwardingruleTimeouts

Algorithm string: Algorithm for the balancing.
DatacenterId string
HealthChecks []GetNetworkloadbalancerForwardingruleHealthCheck: Health check attributes for Network Load Balancer forwarding rule target.
Id string: The id of that Network Load Balancer forwarding rule.
ListenerIp string: Listening IP. (inbound)
ListenerPort float64: Listening port number. (inbound) (range: 1 to 65535)
Name string: The name of that Network Load Balancer forwarding rule.
NetworkloadbalancerId string
Protocol string: Protocol of the balancing.
Targets []GetNetworkloadbalancerForwardingruleTarget: Array of items in that collection.
Timeouts GetNetworkloadbalancerForwardingruleTimeouts

algorithm String: Algorithm for the balancing.
datacenterId String
healthChecks List<GetNetworkloadbalancerForwardingruleHealthCheck>: Health check attributes for Network Load Balancer forwarding rule target.
id String: The id of that Network Load Balancer forwarding rule.
listenerIp String: Listening IP. (inbound)
listenerPort Double: Listening port number. (inbound) (range: 1 to 65535)
name String: The name of that Network Load Balancer forwarding rule.
networkloadbalancerId String
protocol String: Protocol of the balancing.
targets List<GetNetworkloadbalancerForwardingruleTarget>: Array of items in that collection.
timeouts GetNetworkloadbalancerForwardingruleTimeouts

algorithm string: Algorithm for the balancing.
datacenterId string
healthChecks GetNetworkloadbalancerForwardingruleHealthCheck[]: Health check attributes for Network Load Balancer forwarding rule target.
id string: The id of that Network Load Balancer forwarding rule.
listenerIp string: Listening IP. (inbound)
listenerPort number: Listening port number. (inbound) (range: 1 to 65535)
name string: The name of that Network Load Balancer forwarding rule.
networkloadbalancerId string
protocol string: Protocol of the balancing.
targets GetNetworkloadbalancerForwardingruleTarget[]: Array of items in that collection.
timeouts GetNetworkloadbalancerForwardingruleTimeouts

algorithm str: Algorithm for the balancing.
datacenter_id str
health_checks Sequence[GetNetworkloadbalancerForwardingruleHealthCheck]: Health check attributes for Network Load Balancer forwarding rule target.
id str: The id of that Network Load Balancer forwarding rule.
listener_ip str: Listening IP. (inbound)
listener_port float: Listening port number. (inbound) (range: 1 to 65535)
name str: The name of that Network Load Balancer forwarding rule.
networkloadbalancer_id str
protocol str: Protocol of the balancing.
targets Sequence[GetNetworkloadbalancerForwardingruleTarget]: Array of items in that collection.
timeouts GetNetworkloadbalancerForwardingruleTimeouts

algorithm String: Algorithm for the balancing.
datacenterId String
healthChecks List<Property Map>: Health check attributes for Network Load Balancer forwarding rule target.
id String: The id of that Network Load Balancer forwarding rule.
listenerIp String: Listening IP. (inbound)
listenerPort Number: Listening port number. (inbound) (range: 1 to 65535)
name String: The name of that Network Load Balancer forwarding rule.
networkloadbalancerId String
protocol String: Protocol of the balancing.
targets List<Property Map>: Array of items in that collection.
timeouts Property Map

Supporting Types

GetNetworkloadbalancerForwardingruleHealthCheck

ClientTimeout double: ClientTimeout is expressed in milliseconds. This inactivity timeout applies when the client is expected to acknowledge or send data. If unset the default of 50 seconds will be used.
ConnectTimeout double: It specifies the maximum time (in milliseconds) to wait for a connection attempt to a target VM to succeed. If unset, the default of 5 seconds will be used.
Retries double: Retries specifies the number of retries to perform on a target VM after a connection failure. If unset, the default value of 3 will be used.
TargetTimeout double: TargetTimeout specifies the maximum inactivity time (in milliseconds) on the target VM side. If unset, the default of 50 seconds will be used.

ClientTimeout float64: ClientTimeout is expressed in milliseconds. This inactivity timeout applies when the client is expected to acknowledge or send data. If unset the default of 50 seconds will be used.
ConnectTimeout float64: It specifies the maximum time (in milliseconds) to wait for a connection attempt to a target VM to succeed. If unset, the default of 5 seconds will be used.
Retries float64: Retries specifies the number of retries to perform on a target VM after a connection failure. If unset, the default value of 3 will be used.
TargetTimeout float64: TargetTimeout specifies the maximum inactivity time (in milliseconds) on the target VM side. If unset, the default of 50 seconds will be used.

clientTimeout Double: ClientTimeout is expressed in milliseconds. This inactivity timeout applies when the client is expected to acknowledge or send data. If unset the default of 50 seconds will be used.
connectTimeout Double: It specifies the maximum time (in milliseconds) to wait for a connection attempt to a target VM to succeed. If unset, the default of 5 seconds will be used.
retries Double: Retries specifies the number of retries to perform on a target VM after a connection failure. If unset, the default value of 3 will be used.
targetTimeout Double: TargetTimeout specifies the maximum inactivity time (in milliseconds) on the target VM side. If unset, the default of 50 seconds will be used.

clientTimeout number: ClientTimeout is expressed in milliseconds. This inactivity timeout applies when the client is expected to acknowledge or send data. If unset the default of 50 seconds will be used.
connectTimeout number: It specifies the maximum time (in milliseconds) to wait for a connection attempt to a target VM to succeed. If unset, the default of 5 seconds will be used.
retries number: Retries specifies the number of retries to perform on a target VM after a connection failure. If unset, the default value of 3 will be used.
targetTimeout number: TargetTimeout specifies the maximum inactivity time (in milliseconds) on the target VM side. If unset, the default of 50 seconds will be used.

client_timeout float: ClientTimeout is expressed in milliseconds. This inactivity timeout applies when the client is expected to acknowledge or send data. If unset the default of 50 seconds will be used.
connect_timeout float: It specifies the maximum time (in milliseconds) to wait for a connection attempt to a target VM to succeed. If unset, the default of 5 seconds will be used.
retries float: Retries specifies the number of retries to perform on a target VM after a connection failure. If unset, the default value of 3 will be used.
target_timeout float: TargetTimeout specifies the maximum inactivity time (in milliseconds) on the target VM side. If unset, the default of 50 seconds will be used.

clientTimeout Number: ClientTimeout is expressed in milliseconds. This inactivity timeout applies when the client is expected to acknowledge or send data. If unset the default of 50 seconds will be used.
connectTimeout Number: It specifies the maximum time (in milliseconds) to wait for a connection attempt to a target VM to succeed. If unset, the default of 5 seconds will be used.
retries Number: Retries specifies the number of retries to perform on a target VM after a connection failure. If unset, the default value of 3 will be used.
targetTimeout Number: TargetTimeout specifies the maximum inactivity time (in milliseconds) on the target VM side. If unset, the default of 50 seconds will be used.

GetNetworkloadbalancerForwardingruleTarget

HealthChecks List<GetNetworkloadbalancerForwardingruleTargetHealthCheck>: Health check attributes for Network Load Balancer forwarding rule target.
Ip string: IP of a balanced target VM.
Port double: Port of the balanced target service. (range: 1 to 65535).
ProxyProtocol string: The proxy protocol version.
Weight double: Weight parameter is used to adjust the target VM's weight relative to other target VMs.

HealthChecks []GetNetworkloadbalancerForwardingruleTargetHealthCheck: Health check attributes for Network Load Balancer forwarding rule target.
Ip string: IP of a balanced target VM.
Port float64: Port of the balanced target service. (range: 1 to 65535).
ProxyProtocol string: The proxy protocol version.
Weight float64: Weight parameter is used to adjust the target VM's weight relative to other target VMs.

healthChecks List<GetNetworkloadbalancerForwardingruleTargetHealthCheck>: Health check attributes for Network Load Balancer forwarding rule target.
ip String: IP of a balanced target VM.
port Double: Port of the balanced target service. (range: 1 to 65535).
proxyProtocol String: The proxy protocol version.
weight Double: Weight parameter is used to adjust the target VM's weight relative to other target VMs.

healthChecks GetNetworkloadbalancerForwardingruleTargetHealthCheck[]: Health check attributes for Network Load Balancer forwarding rule target.
ip string: IP of a balanced target VM.
port number: Port of the balanced target service. (range: 1 to 65535).
proxyProtocol string: The proxy protocol version.
weight number: Weight parameter is used to adjust the target VM's weight relative to other target VMs.

health_checks Sequence[GetNetworkloadbalancerForwardingruleTargetHealthCheck]: Health check attributes for Network Load Balancer forwarding rule target.
ip str: IP of a balanced target VM.
port float: Port of the balanced target service. (range: 1 to 65535).
proxy_protocol str: The proxy protocol version.
weight float: Weight parameter is used to adjust the target VM's weight relative to other target VMs.

healthChecks List<Property Map>: Health check attributes for Network Load Balancer forwarding rule target.
ip String: IP of a balanced target VM.
port Number: Port of the balanced target service. (range: 1 to 65535).
proxyProtocol String: The proxy protocol version.
weight Number: Weight parameter is used to adjust the target VM's weight relative to other target VMs.

GetNetworkloadbalancerForwardingruleTargetHealthCheck

Check bool: Check specifies whether the target VM's health is checked.
CheckInterval double: CheckInterval determines the duration (in milliseconds) between consecutive health checks. If unspecified a default of 2000 ms is used.
Maintenance bool: Maintenance specifies if a target VM should be marked as down, even if it is not.

Check bool: Check specifies whether the target VM's health is checked.
CheckInterval float64: CheckInterval determines the duration (in milliseconds) between consecutive health checks. If unspecified a default of 2000 ms is used.
Maintenance bool: Maintenance specifies if a target VM should be marked as down, even if it is not.

check Boolean: Check specifies whether the target VM's health is checked.
checkInterval Double: CheckInterval determines the duration (in milliseconds) between consecutive health checks. If unspecified a default of 2000 ms is used.
maintenance Boolean: Maintenance specifies if a target VM should be marked as down, even if it is not.

check boolean: Check specifies whether the target VM's health is checked.
checkInterval number: CheckInterval determines the duration (in milliseconds) between consecutive health checks. If unspecified a default of 2000 ms is used.
maintenance boolean: Maintenance specifies if a target VM should be marked as down, even if it is not.

check bool: Check specifies whether the target VM's health is checked.
check_interval float: CheckInterval determines the duration (in milliseconds) between consecutive health checks. If unspecified a default of 2000 ms is used.
maintenance bool: Maintenance specifies if a target VM should be marked as down, even if it is not.

check Boolean: Check specifies whether the target VM's health is checked.
checkInterval Number: CheckInterval determines the duration (in milliseconds) between consecutive health checks. If unspecified a default of 2000 ms is used.
maintenance Boolean: Maintenance specifies if a target VM should be marked as down, even if it is not.

GetNetworkloadbalancerForwardingruleTimeouts

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

On this page

On this page

By ID

By Name

Using getNetworkloadbalancerForwardingrule

getNetworkloadbalancerForwardingrule Result

Supporting Types

GetNetworkloadbalancerForwardingruleHealthCheck

GetNetworkloadbalancerForwardingruleTarget

GetNetworkloadbalancerForwardingruleTargetHealthCheck

GetNetworkloadbalancerForwardingruleTimeouts

Package Details

On this page

On this page