oci.NetworkLoadBalancer.getNetworkLoadBalancerHealth

Oracle Cloud Infrastructure v4.3.0, Mar 19 26

Viewing docs for Oracle Cloud Infrastructure v4.3.0
published on Thursday, Mar 19, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-oci

Viewing docs for Oracle Cloud Infrastructure v4.3.0
published on Thursday, Mar 19, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-oci

Example Usage

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

const testNetworkLoadBalancerHealth = oci.NetworkLoadBalancer.getNetworkLoadBalancerHealth({
    networkLoadBalancerId: testNetworkLoadBalancer.id,
});

import pulumi
import pulumi_oci as oci

test_network_load_balancer_health = oci.NetworkLoadBalancer.get_network_load_balancer_health(network_load_balancer_id=test_network_load_balancer["id"])

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := networkloadbalancer.GetNetworkLoadBalancerHealth(ctx, &networkloadbalancer.GetNetworkLoadBalancerHealthArgs{
			NetworkLoadBalancerId: testNetworkLoadBalancer.Id,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var testNetworkLoadBalancerHealth = Oci.NetworkLoadBalancer.GetNetworkLoadBalancerHealth.Invoke(new()
    {
        NetworkLoadBalancerId = testNetworkLoadBalancer.Id,
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.NetworkLoadBalancer.NetworkLoadBalancerFunctions;
import com.pulumi.oci.NetworkLoadBalancer.inputs.GetNetworkLoadBalancerHealthArgs;
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 testNetworkLoadBalancerHealth = NetworkLoadBalancerFunctions.getNetworkLoadBalancerHealth(GetNetworkLoadBalancerHealthArgs.builder()
            .networkLoadBalancerId(testNetworkLoadBalancer.id())
            .build());

    }
}

variables:
  testNetworkLoadBalancerHealth:
    fn::invoke:
      function: oci:NetworkLoadBalancer:getNetworkLoadBalancerHealth
      arguments:
        networkLoadBalancerId: ${testNetworkLoadBalancer.id}

Using getNetworkLoadBalancerHealth

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 getNetworkLoadBalancerHealth(args: GetNetworkLoadBalancerHealthArgs, opts?: InvokeOptions): Promise<GetNetworkLoadBalancerHealthResult>
function getNetworkLoadBalancerHealthOutput(args: GetNetworkLoadBalancerHealthOutputArgs, opts?: InvokeOptions): Output<GetNetworkLoadBalancerHealthResult>

def get_network_load_balancer_health(network_load_balancer_id: Optional[str] = None,
                                     opts: Optional[InvokeOptions] = None) -> GetNetworkLoadBalancerHealthResult
def get_network_load_balancer_health_output(network_load_balancer_id: Optional[pulumi.Input[str]] = None,
                                     opts: Optional[InvokeOptions] = None) -> Output[GetNetworkLoadBalancerHealthResult]

func GetNetworkLoadBalancerHealth(ctx *Context, args *GetNetworkLoadBalancerHealthArgs, opts ...InvokeOption) (*GetNetworkLoadBalancerHealthResult, error)
func GetNetworkLoadBalancerHealthOutput(ctx *Context, args *GetNetworkLoadBalancerHealthOutputArgs, opts ...InvokeOption) GetNetworkLoadBalancerHealthResultOutput

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

public static class GetNetworkLoadBalancerHealth 
{
    public static Task<GetNetworkLoadBalancerHealthResult> InvokeAsync(GetNetworkLoadBalancerHealthArgs args, InvokeOptions? opts = null)
    public static Output<GetNetworkLoadBalancerHealthResult> Invoke(GetNetworkLoadBalancerHealthInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetNetworkLoadBalancerHealthResult> getNetworkLoadBalancerHealth(GetNetworkLoadBalancerHealthArgs args, InvokeOptions options)
public static Output<GetNetworkLoadBalancerHealthResult> getNetworkLoadBalancerHealth(GetNetworkLoadBalancerHealthArgs args, InvokeOptions options)

fn::invoke:
  function: oci:NetworkLoadBalancer/getNetworkLoadBalancerHealth:getNetworkLoadBalancerHealth
  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.

getNetworkLoadBalancerHealth Result

The following output properties are available:

CriticalStateBackendSetNames List<string>

A list of backend sets that are currently in the CRITICAL health state. The list identifies each backend set by the user-friendly name you assigned when you created the backend set. Example: example_backend_set

Id string

The provider-assigned unique ID for this managed resource.

NetworkLoadBalancerId string

Status string

The overall health status of the network load balancer.

OK: All backend sets associated with the network load balancer return a status of OK.
WARNING: At least one of the backend sets associated with the network load balancer returns a status of WARNING, no backend sets return a status of CRITICAL, and the network load balancer life cycle state is ACTIVE.
CRITICAL: One or more of the backend sets associated with the network load balancer return a status of CRITICAL.
UNKNOWN: If any one of the following conditions is true:
The network load balancer life cycle state is not ACTIVE.
No backend sets are defined for the network load balancer.
More than half of the backend sets associated with the network load balancer return a status of UNKNOWN, none of the backend sets return a status of WARNING or CRITICAL, and the network load balancer life cycle state is ACTIVE.
The system could not retrieve metrics for any reason.

TotalBackendSetCount int

The total number of backend sets associated with this network load balancer. Example: 4

UnknownStateBackendSetNames List<string>

A list of backend sets that are currently in the UNKNOWN health state. The list identifies each backend set by the user-friendly name you assigned when you created the backend set. Example: example_backend_set2

WarningStateBackendSetNames List<string>

A list of backend sets that are currently in the WARNING health state. The list identifies each backend set by the user-friendly name you assigned when you created the backend set. Example: example_backend_set3

CriticalStateBackendSetNames []string

Id string

The provider-assigned unique ID for this managed resource.

NetworkLoadBalancerId string

Status string

The overall health status of the network load balancer.

OK: All backend sets associated with the network load balancer return a status of OK.
WARNING: At least one of the backend sets associated with the network load balancer returns a status of WARNING, no backend sets return a status of CRITICAL, and the network load balancer life cycle state is ACTIVE.
CRITICAL: One or more of the backend sets associated with the network load balancer return a status of CRITICAL.
UNKNOWN: If any one of the following conditions is true:
The network load balancer life cycle state is not ACTIVE.
No backend sets are defined for the network load balancer.
More than half of the backend sets associated with the network load balancer return a status of UNKNOWN, none of the backend sets return a status of WARNING or CRITICAL, and the network load balancer life cycle state is ACTIVE.
The system could not retrieve metrics for any reason.

TotalBackendSetCount int

The total number of backend sets associated with this network load balancer. Example: 4

UnknownStateBackendSetNames []string

WarningStateBackendSetNames []string

criticalStateBackendSetNames List<String>

id String

The provider-assigned unique ID for this managed resource.

networkLoadBalancerId String

status String

The overall health status of the network load balancer.

OK: All backend sets associated with the network load balancer return a status of OK.
WARNING: At least one of the backend sets associated with the network load balancer returns a status of WARNING, no backend sets return a status of CRITICAL, and the network load balancer life cycle state is ACTIVE.
CRITICAL: One or more of the backend sets associated with the network load balancer return a status of CRITICAL.
UNKNOWN: If any one of the following conditions is true:
The network load balancer life cycle state is not ACTIVE.
No backend sets are defined for the network load balancer.
More than half of the backend sets associated with the network load balancer return a status of UNKNOWN, none of the backend sets return a status of WARNING or CRITICAL, and the network load balancer life cycle state is ACTIVE.
The system could not retrieve metrics for any reason.

totalBackendSetCount Integer

The total number of backend sets associated with this network load balancer. Example: 4

unknownStateBackendSetNames List<String>

warningStateBackendSetNames List<String>

criticalStateBackendSetNames string[]

id string

The provider-assigned unique ID for this managed resource.

networkLoadBalancerId string

status string

The overall health status of the network load balancer.

OK: All backend sets associated with the network load balancer return a status of OK.
WARNING: At least one of the backend sets associated with the network load balancer returns a status of WARNING, no backend sets return a status of CRITICAL, and the network load balancer life cycle state is ACTIVE.
CRITICAL: One or more of the backend sets associated with the network load balancer return a status of CRITICAL.
UNKNOWN: If any one of the following conditions is true:
The network load balancer life cycle state is not ACTIVE.
No backend sets are defined for the network load balancer.
More than half of the backend sets associated with the network load balancer return a status of UNKNOWN, none of the backend sets return a status of WARNING or CRITICAL, and the network load balancer life cycle state is ACTIVE.
The system could not retrieve metrics for any reason.

totalBackendSetCount number

The total number of backend sets associated with this network load balancer. Example: 4

unknownStateBackendSetNames string[]

warningStateBackendSetNames string[]

critical_state_backend_set_names Sequence[str]

id str

The provider-assigned unique ID for this managed resource.

network_load_balancer_id str

status str

The overall health status of the network load balancer.

OK: All backend sets associated with the network load balancer return a status of OK.
WARNING: At least one of the backend sets associated with the network load balancer returns a status of WARNING, no backend sets return a status of CRITICAL, and the network load balancer life cycle state is ACTIVE.
CRITICAL: One or more of the backend sets associated with the network load balancer return a status of CRITICAL.
UNKNOWN: If any one of the following conditions is true:
The network load balancer life cycle state is not ACTIVE.
No backend sets are defined for the network load balancer.
More than half of the backend sets associated with the network load balancer return a status of UNKNOWN, none of the backend sets return a status of WARNING or CRITICAL, and the network load balancer life cycle state is ACTIVE.
The system could not retrieve metrics for any reason.

total_backend_set_count int

The total number of backend sets associated with this network load balancer. Example: 4

unknown_state_backend_set_names Sequence[str]

warning_state_backend_set_names Sequence[str]

criticalStateBackendSetNames List<String>

id String

The provider-assigned unique ID for this managed resource.

networkLoadBalancerId String

status String

The overall health status of the network load balancer.

OK: All backend sets associated with the network load balancer return a status of OK.
WARNING: At least one of the backend sets associated with the network load balancer returns a status of WARNING, no backend sets return a status of CRITICAL, and the network load balancer life cycle state is ACTIVE.
CRITICAL: One or more of the backend sets associated with the network load balancer return a status of CRITICAL.
UNKNOWN: If any one of the following conditions is true:
The network load balancer life cycle state is not ACTIVE.
No backend sets are defined for the network load balancer.
More than half of the backend sets associated with the network load balancer return a status of UNKNOWN, none of the backend sets return a status of WARNING or CRITICAL, and the network load balancer life cycle state is ACTIVE.
The system could not retrieve metrics for any reason.

totalBackendSetCount Number