Oracle Cloud Infrastructure

Pulumi Official
Package maintained by Pulumi
v0.1.1 published on Tuesday, May 3, 2022 by Pulumi

getNetworkLoadBalancer

This data source provides details about a specific Network Load Balancer resource in Oracle Cloud Infrastructure Network Load Balancer service.

Retrieves network load balancer configuration information by identifier.

Example Usage

using Pulumi;
using Oci = Pulumi.Oci;

class MyStack : Stack
{
    public MyStack()
    {
        var testNetworkLoadBalancer = Output.Create(Oci.NetworkLoadBalancer.GetNetworkLoadBalancer.InvokeAsync(new Oci.NetworkLoadBalancer.GetNetworkLoadBalancerArgs
        {
            NetworkLoadBalancerId = oci_network_load_balancer_network_load_balancer.Test_network_load_balancer.Id,
        }));
    }

}
package main

import (
	"github.com/pulumi/pulumi-oci/sdk/go/oci/NetworkLoadBalancer"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := NetworkLoadBalancer.GetNetworkLoadBalancer(ctx, &networkloadbalancer.GetNetworkLoadBalancerArgs{
			NetworkLoadBalancerId: oci_network_load_balancer_network_load_balancer.Test_network_load_balancer.Id,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

Coming soon!

import pulumi
import pulumi_oci as oci

test_network_load_balancer = oci.NetworkLoadBalancer.get_network_load_balancer(network_load_balancer_id=oci_network_load_balancer_network_load_balancer["test_network_load_balancer"]["id"])
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";

const testNetworkLoadBalancer = oci.NetworkLoadBalancer.getNetworkLoadBalancer({
    networkLoadBalancerId: oci_network_load_balancer_network_load_balancer.test_network_load_balancer.id,
});

Coming soon!

Using getNetworkLoadBalancer

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 getNetworkLoadBalancer(args: GetNetworkLoadBalancerArgs, opts?: InvokeOptions): Promise<GetNetworkLoadBalancerResult>
function getNetworkLoadBalancerOutput(args: GetNetworkLoadBalancerOutputArgs, opts?: InvokeOptions): Output<GetNetworkLoadBalancerResult>
def get_network_load_balancer(network_load_balancer_id: Optional[str] = None,
                              opts: Optional[InvokeOptions] = None) -> GetNetworkLoadBalancerResult
def get_network_load_balancer_output(network_load_balancer_id: Optional[pulumi.Input[str]] = None,
                              opts: Optional[InvokeOptions] = None) -> Output[GetNetworkLoadBalancerResult]
func GetNetworkLoadBalancer(ctx *Context, args *GetNetworkLoadBalancerArgs, opts ...InvokeOption) (*GetNetworkLoadBalancerResult, error)
func GetNetworkLoadBalancerOutput(ctx *Context, args *GetNetworkLoadBalancerOutputArgs, opts ...InvokeOption) GetNetworkLoadBalancerResultOutput

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

public static class GetNetworkLoadBalancer 
{
    public static Task<GetNetworkLoadBalancerResult> InvokeAsync(GetNetworkLoadBalancerArgs args, InvokeOptions? opts = null)
    public static Output<GetNetworkLoadBalancerResult> Invoke(GetNetworkLoadBalancerInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetNetworkLoadBalancerResult> getNetworkLoadBalancer(GetNetworkLoadBalancerArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
Fn::Invoke:
  Function: oci:NetworkLoadBalancer/getNetworkLoadBalancer:getNetworkLoadBalancer
  Arguments:
    # Arguments dictionary

The following arguments are supported:

NetworkLoadBalancerId string

The OCID of the network load balancer to update.

NetworkLoadBalancerId string

The OCID of the network load balancer to update.

networkLoadBalancerId String

The OCID of the network load balancer to update.

networkLoadBalancerId string

The OCID of the network load balancer to update.

network_load_balancer_id str

The OCID of the network load balancer to update.

networkLoadBalancerId String

The OCID of the network load balancer to update.

getNetworkLoadBalancer Result

The following output properties are available:

CompartmentId string

The OCID of the compartment containing the network load balancer.

DefinedTags Dictionary<string, object>

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

DisplayName string

A user-friendly name, which does not have to be unique, and can be changed. Example: example_load_balancer

FreeformTags Dictionary<string, object>

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

Id string

OCID of the reserved public IP address created with the virtual cloud network.

IpAddresses List<GetNetworkLoadBalancerIpAddress>

An array of IP addresses.

IsPreserveSourceDestination bool

When enabled, the skipSourceDestinationCheck parameter is automatically enabled on the load balancer VNIC. Packets are sent to the backend set without any changes to the source and destination IP.

IsPrivate bool

Whether the network load balancer has a virtual cloud network-local (private) IP address.

LifecycleDetails string

A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in Failed state.

NetworkLoadBalancerId string
NetworkSecurityGroupIds List<string>

An array of network security groups OCIDs associated with the network load balancer.

NlbIpVersion string

IP version associated with the NLB.

ReservedIps List<GetNetworkLoadBalancerReservedIp>
State string

The current state of the network load balancer.

SubnetId string

The subnet in which the network load balancer is spawned OCIDs."

SystemTags Dictionary<string, object>

Key-value pair representing system tags' keys and values scoped to a namespace. Example: {"bar-key": "value"}

TimeCreated string

The date and time the network load balancer was created, in the format defined by RFC3339. Example: 2020-05-01T21:10:29.600Z

TimeUpdated string

The time the network load balancer was updated. An RFC3339 formatted date-time string. Example: 2020-05-01T22:10:29.600Z

CompartmentId string

The OCID of the compartment containing the network load balancer.

DefinedTags map[string]interface{}

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

DisplayName string

A user-friendly name, which does not have to be unique, and can be changed. Example: example_load_balancer

FreeformTags map[string]interface{}

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

Id string

OCID of the reserved public IP address created with the virtual cloud network.

IpAddresses []GetNetworkLoadBalancerIpAddress

An array of IP addresses.

IsPreserveSourceDestination bool

When enabled, the skipSourceDestinationCheck parameter is automatically enabled on the load balancer VNIC. Packets are sent to the backend set without any changes to the source and destination IP.

IsPrivate bool

Whether the network load balancer has a virtual cloud network-local (private) IP address.

LifecycleDetails string

A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in Failed state.

NetworkLoadBalancerId string
NetworkSecurityGroupIds []string

An array of network security groups OCIDs associated with the network load balancer.

NlbIpVersion string

IP version associated with the NLB.

ReservedIps []GetNetworkLoadBalancerReservedIp
State string

The current state of the network load balancer.

SubnetId string

The subnet in which the network load balancer is spawned OCIDs."

SystemTags map[string]interface{}

Key-value pair representing system tags' keys and values scoped to a namespace. Example: {"bar-key": "value"}

TimeCreated string

The date and time the network load balancer was created, in the format defined by RFC3339. Example: 2020-05-01T21:10:29.600Z

TimeUpdated string

The time the network load balancer was updated. An RFC3339 formatted date-time string. Example: 2020-05-01T22:10:29.600Z

compartmentId String

The OCID of the compartment containing the network load balancer.

definedTags Map<String,Object>

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

displayName String

A user-friendly name, which does not have to be unique, and can be changed. Example: example_load_balancer

freeformTags Map<String,Object>

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

id String

OCID of the reserved public IP address created with the virtual cloud network.

ipAddresses List<GetIpAddress>

An array of IP addresses.

isPreserveSourceDestination Boolean

When enabled, the skipSourceDestinationCheck parameter is automatically enabled on the load balancer VNIC. Packets are sent to the backend set without any changes to the source and destination IP.

isPrivate Boolean

Whether the network load balancer has a virtual cloud network-local (private) IP address.

lifecycleDetails String

A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in Failed state.

networkLoadBalancerId String
networkSecurityGroupIds List<String>

An array of network security groups OCIDs associated with the network load balancer.

nlbIpVersion String

IP version associated with the NLB.

reservedIps List<GetReservedIp>
state String

The current state of the network load balancer.

subnetId String

The subnet in which the network load balancer is spawned OCIDs."

systemTags Map<String,Object>

Key-value pair representing system tags' keys and values scoped to a namespace. Example: {"bar-key": "value"}

timeCreated String

The date and time the network load balancer was created, in the format defined by RFC3339. Example: 2020-05-01T21:10:29.600Z

timeUpdated String

The time the network load balancer was updated. An RFC3339 formatted date-time string. Example: 2020-05-01T22:10:29.600Z

compartmentId string

The OCID of the compartment containing the network load balancer.

definedTags {[key: string]: any}

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

displayName string

A user-friendly name, which does not have to be unique, and can be changed. Example: example_load_balancer

freeformTags {[key: string]: any}

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

id string

OCID of the reserved public IP address created with the virtual cloud network.

ipAddresses GetNetworkLoadBalancerIpAddress[]

An array of IP addresses.

isPreserveSourceDestination boolean

When enabled, the skipSourceDestinationCheck parameter is automatically enabled on the load balancer VNIC. Packets are sent to the backend set without any changes to the source and destination IP.

isPrivate boolean

Whether the network load balancer has a virtual cloud network-local (private) IP address.

lifecycleDetails string

A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in Failed state.

networkLoadBalancerId string
networkSecurityGroupIds string[]

An array of network security groups OCIDs associated with the network load balancer.

nlbIpVersion string

IP version associated with the NLB.

reservedIps GetNetworkLoadBalancerReservedIp[]
state string

The current state of the network load balancer.

subnetId string

The subnet in which the network load balancer is spawned OCIDs."

systemTags {[key: string]: any}

Key-value pair representing system tags' keys and values scoped to a namespace. Example: {"bar-key": "value"}

timeCreated string

The date and time the network load balancer was created, in the format defined by RFC3339. Example: 2020-05-01T21:10:29.600Z

timeUpdated string

The time the network load balancer was updated. An RFC3339 formatted date-time string. Example: 2020-05-01T22:10:29.600Z

compartment_id str

The OCID of the compartment containing the network load balancer.

defined_tags Mapping[str, Any]

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

display_name str

A user-friendly name, which does not have to be unique, and can be changed. Example: example_load_balancer

freeform_tags Mapping[str, Any]

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

id str

OCID of the reserved public IP address created with the virtual cloud network.

ip_addresses GetNetworkLoadBalancerIpAddress]

An array of IP addresses.

is_preserve_source_destination bool

When enabled, the skipSourceDestinationCheck parameter is automatically enabled on the load balancer VNIC. Packets are sent to the backend set without any changes to the source and destination IP.

is_private bool

Whether the network load balancer has a virtual cloud network-local (private) IP address.

lifecycle_details str

A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in Failed state.

network_load_balancer_id str
network_security_group_ids Sequence[str]

An array of network security groups OCIDs associated with the network load balancer.

nlb_ip_version str

IP version associated with the NLB.

reserved_ips GetNetworkLoadBalancerReservedIp]
state str

The current state of the network load balancer.

subnet_id str

The subnet in which the network load balancer is spawned OCIDs."

system_tags Mapping[str, Any]

Key-value pair representing system tags' keys and values scoped to a namespace. Example: {"bar-key": "value"}

time_created str

The date and time the network load balancer was created, in the format defined by RFC3339. Example: 2020-05-01T21:10:29.600Z

time_updated str

The time the network load balancer was updated. An RFC3339 formatted date-time string. Example: 2020-05-01T22:10:29.600Z

compartmentId String

The OCID of the compartment containing the network load balancer.

definedTags Map<Any>

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

displayName String

A user-friendly name, which does not have to be unique, and can be changed. Example: example_load_balancer

freeformTags Map<Any>

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

id String

OCID of the reserved public IP address created with the virtual cloud network.

ipAddresses List<Property Map>

An array of IP addresses.

isPreserveSourceDestination Boolean

When enabled, the skipSourceDestinationCheck parameter is automatically enabled on the load balancer VNIC. Packets are sent to the backend set without any changes to the source and destination IP.

isPrivate Boolean

Whether the network load balancer has a virtual cloud network-local (private) IP address.

lifecycleDetails String

A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in Failed state.

networkLoadBalancerId String
networkSecurityGroupIds List<String>

An array of network security groups OCIDs associated with the network load balancer.

nlbIpVersion String

IP version associated with the NLB.

reservedIps List<Property Map>
state String

The current state of the network load balancer.

subnetId String

The subnet in which the network load balancer is spawned OCIDs."

systemTags Map<Any>

Key-value pair representing system tags' keys and values scoped to a namespace. Example: {"bar-key": "value"}

timeCreated String

The date and time the network load balancer was created, in the format defined by RFC3339. Example: 2020-05-01T21:10:29.600Z

timeUpdated String

The time the network load balancer was updated. An RFC3339 formatted date-time string. Example: 2020-05-01T22:10:29.600Z

Supporting Types

GetNetworkLoadBalancerIpAddress

IpAddress string

An IP address. Example: 192.168.0.3

IpVersion string

IP version associated with this IP address.

IsPublic bool

Whether the IP address is public or private.

ReservedIps List<GetNetworkLoadBalancerIpAddressReservedIp>

An object representing a reserved IP address to be attached or that is already attached to a network load balancer.

IpAddress string

An IP address. Example: 192.168.0.3

IpVersion string

IP version associated with this IP address.

IsPublic bool

Whether the IP address is public or private.

ReservedIps []GetNetworkLoadBalancerIpAddressReservedIp

An object representing a reserved IP address to be attached or that is already attached to a network load balancer.

ipAddress String

An IP address. Example: 192.168.0.3

ipVersion String

IP version associated with this IP address.

isPublic Boolean

Whether the IP address is public or private.

reservedIps List<GetIpAddressReservedIp>

An object representing a reserved IP address to be attached or that is already attached to a network load balancer.

ipAddress string

An IP address. Example: 192.168.0.3

ipVersion string

IP version associated with this IP address.

isPublic boolean

Whether the IP address is public or private.

reservedIps GetNetworkLoadBalancerIpAddressReservedIp[]

An object representing a reserved IP address to be attached or that is already attached to a network load balancer.

ip_address str

An IP address. Example: 192.168.0.3

ip_version str

IP version associated with this IP address.

is_public bool

Whether the IP address is public or private.

reserved_ips GetNetworkLoadBalancerIpAddressReservedIp]

An object representing a reserved IP address to be attached or that is already attached to a network load balancer.

ipAddress String

An IP address. Example: 192.168.0.3

ipVersion String

IP version associated with this IP address.

isPublic Boolean

Whether the IP address is public or private.

reservedIps List<Property Map>

An object representing a reserved IP address to be attached or that is already attached to a network load balancer.

GetNetworkLoadBalancerIpAddressReservedIp

Id string

OCID of the reserved public IP address created with the virtual cloud network.

Id string

OCID of the reserved public IP address created with the virtual cloud network.

id String

OCID of the reserved public IP address created with the virtual cloud network.

id string

OCID of the reserved public IP address created with the virtual cloud network.

id str

OCID of the reserved public IP address created with the virtual cloud network.

id String

OCID of the reserved public IP address created with the virtual cloud network.

GetNetworkLoadBalancerReservedIp

Id string

OCID of the reserved public IP address created with the virtual cloud network.

Id string

OCID of the reserved public IP address created with the virtual cloud network.

id String

OCID of the reserved public IP address created with the virtual cloud network.

id string

OCID of the reserved public IP address created with the virtual cloud network.

id str

OCID of the reserved public IP address created with the virtual cloud network.

id String

OCID of the reserved public IP address created with the virtual cloud network.

Package Details

Repository
https://github.com/pulumi/pulumi-oci
License
Apache-2.0
Notes

This Pulumi package is based on the oci Terraform Provider.