1. Packages
  2. Yandex
  3. API Docs
  4. getLbNetworkLoadBalancer
Yandex v0.13.0 published on Tuesday, Feb 22, 2022 by Pulumi

yandex.getLbNetworkLoadBalancer

Explore with Pulumi AI

yandex logo
Yandex v0.13.0 published on Tuesday, Feb 22, 2022 by Pulumi

    Get information about a Yandex Load Balancer network load balancer. For more information, see Yandex.Cloud Network Load Balancer.

    import * as pulumi from "@pulumi/pulumi";
    import * as yandex from "@pulumi/yandex";
    
    const foo = pulumi.output(yandex.getLbNetworkLoadBalancer({
        networkLoadBalancerId: "my-network-load-balancer",
    }));
    
    import pulumi
    import pulumi_yandex as yandex
    
    foo = yandex.get_lb_network_load_balancer(network_load_balancer_id="my-network-load-balancer")
    
    using Pulumi;
    using Yandex = Pulumi.Yandex;
    
    class MyStack : Stack
    {
        public MyStack()
        {
            var foo = Output.Create(Yandex.GetLbNetworkLoadBalancer.InvokeAsync(new Yandex.GetLbNetworkLoadBalancerArgs
            {
                NetworkLoadBalancerId = "my-network-load-balancer",
            }));
        }
    
    }
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-yandex/sdk/go/yandex"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		opt0 := "my-network-load-balancer"
    		_, err := yandex.LookupLbNetworkLoadBalancer(ctx, &GetLbNetworkLoadBalancerArgs{
    			NetworkLoadBalancerId: &opt0,
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    

    This data source is used to define [Load Balancer Network Load Balancers] that can be used by other resources.

    Using getLbNetworkLoadBalancer

    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 getLbNetworkLoadBalancer(args: GetLbNetworkLoadBalancerArgs, opts?: InvokeOptions): Promise<GetLbNetworkLoadBalancerResult>
    function getLbNetworkLoadBalancerOutput(args: GetLbNetworkLoadBalancerOutputArgs, opts?: InvokeOptions): Output<GetLbNetworkLoadBalancerResult>
    def get_lb_network_load_balancer(folder_id: Optional[str] = None,
                                     name: Optional[str] = None,
                                     network_load_balancer_id: Optional[str] = None,
                                     opts: Optional[InvokeOptions] = None) -> GetLbNetworkLoadBalancerResult
    def get_lb_network_load_balancer_output(folder_id: Optional[pulumi.Input[str]] = None,
                                     name: Optional[pulumi.Input[str]] = None,
                                     network_load_balancer_id: Optional[pulumi.Input[str]] = None,
                                     opts: Optional[InvokeOptions] = None) -> Output[GetLbNetworkLoadBalancerResult]
    func LookupLbNetworkLoadBalancer(ctx *Context, args *LookupLbNetworkLoadBalancerArgs, opts ...InvokeOption) (*LookupLbNetworkLoadBalancerResult, error)
    func LookupLbNetworkLoadBalancerOutput(ctx *Context, args *LookupLbNetworkLoadBalancerOutputArgs, opts ...InvokeOption) LookupLbNetworkLoadBalancerResultOutput

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

    public static class GetLbNetworkLoadBalancer 
    {
        public static Task<GetLbNetworkLoadBalancerResult> InvokeAsync(GetLbNetworkLoadBalancerArgs args, InvokeOptions? opts = null)
        public static Output<GetLbNetworkLoadBalancerResult> Invoke(GetLbNetworkLoadBalancerInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetLbNetworkLoadBalancerResult> getLbNetworkLoadBalancer(GetLbNetworkLoadBalancerArgs args, InvokeOptions options)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: yandex:index/getLbNetworkLoadBalancer:getLbNetworkLoadBalancer
      arguments:
        # arguments dictionary

    The following arguments are supported:

    FolderId string

    Folder that the resource belongs to. If value is omitted, the default provider folder is used.

    Name string
    • Name of the network load balancer.
    NetworkLoadBalancerId string

    Network load balancer ID.

    FolderId string

    Folder that the resource belongs to. If value is omitted, the default provider folder is used.

    Name string
    • Name of the network load balancer.
    NetworkLoadBalancerId string

    Network load balancer ID.

    folderId String

    Folder that the resource belongs to. If value is omitted, the default provider folder is used.

    name String
    • Name of the network load balancer.
    networkLoadBalancerId String

    Network load balancer ID.

    folderId string

    Folder that the resource belongs to. If value is omitted, the default provider folder is used.

    name string
    • Name of the network load balancer.
    networkLoadBalancerId string

    Network load balancer ID.

    folder_id str

    Folder that the resource belongs to. If value is omitted, the default provider folder is used.

    name str
    • Name of the network load balancer.
    network_load_balancer_id str

    Network load balancer ID.

    folderId String

    Folder that the resource belongs to. If value is omitted, the default provider folder is used.

    name String
    • Name of the network load balancer.
    networkLoadBalancerId String

    Network load balancer ID.

    getLbNetworkLoadBalancer Result

    The following output properties are available:

    AttachedTargetGroups List<GetLbNetworkLoadBalancerAttachedTargetGroup>

    An attached target group is a group of targets that is attached to a load balancer. Structure is documented below.

    CreatedAt string

    Creation timestamp of this network load balancer.

    Description string

    Description of the network load balancer.

    FolderId string
    Id string

    The provider-assigned unique ID for this managed resource.

    Labels Dictionary<string, string>

    Labels to assign to this network load balancer.

    Listeners List<GetLbNetworkLoadBalancerListener>

    Listener specification that will be used by a network load balancer. Structure is documented below.

    Name string

    Name of the listener.

    NetworkLoadBalancerId string
    RegionId string

    ID of the region where the network load balancer resides.

    Type string

    Type of the network load balancer.

    AttachedTargetGroups []GetLbNetworkLoadBalancerAttachedTargetGroup

    An attached target group is a group of targets that is attached to a load balancer. Structure is documented below.

    CreatedAt string

    Creation timestamp of this network load balancer.

    Description string

    Description of the network load balancer.

    FolderId string
    Id string

    The provider-assigned unique ID for this managed resource.

    Labels map[string]string

    Labels to assign to this network load balancer.

    Listeners []GetLbNetworkLoadBalancerListener

    Listener specification that will be used by a network load balancer. Structure is documented below.

    Name string

    Name of the listener.

    NetworkLoadBalancerId string
    RegionId string

    ID of the region where the network load balancer resides.

    Type string

    Type of the network load balancer.

    attachedTargetGroups List<GetLbNetworkLoadBalancerAttachedTargetGroup>

    An attached target group is a group of targets that is attached to a load balancer. Structure is documented below.

    createdAt String

    Creation timestamp of this network load balancer.

    description String

    Description of the network load balancer.

    folderId String
    id String

    The provider-assigned unique ID for this managed resource.

    labels Map<String,String>

    Labels to assign to this network load balancer.

    listeners List<GetLbNetworkLoadBalancerListener>

    Listener specification that will be used by a network load balancer. Structure is documented below.

    name String

    Name of the listener.

    networkLoadBalancerId String
    regionId String

    ID of the region where the network load balancer resides.

    type String

    Type of the network load balancer.

    attachedTargetGroups GetLbNetworkLoadBalancerAttachedTargetGroup[]

    An attached target group is a group of targets that is attached to a load balancer. Structure is documented below.

    createdAt string

    Creation timestamp of this network load balancer.

    description string

    Description of the network load balancer.

    folderId string
    id string

    The provider-assigned unique ID for this managed resource.

    labels {[key: string]: string}

    Labels to assign to this network load balancer.

    listeners GetLbNetworkLoadBalancerListener[]

    Listener specification that will be used by a network load balancer. Structure is documented below.

    name string

    Name of the listener.

    networkLoadBalancerId string
    regionId string

    ID of the region where the network load balancer resides.

    type string

    Type of the network load balancer.

    attached_target_groups Sequence[GetLbNetworkLoadBalancerAttachedTargetGroup]

    An attached target group is a group of targets that is attached to a load balancer. Structure is documented below.

    created_at str

    Creation timestamp of this network load balancer.

    description str

    Description of the network load balancer.

    folder_id str
    id str

    The provider-assigned unique ID for this managed resource.

    labels Mapping[str, str]

    Labels to assign to this network load balancer.

    listeners Sequence[GetLbNetworkLoadBalancerListener]

    Listener specification that will be used by a network load balancer. Structure is documented below.

    name str

    Name of the listener.

    network_load_balancer_id str
    region_id str

    ID of the region where the network load balancer resides.

    type str

    Type of the network load balancer.

    attachedTargetGroups List<Property Map>

    An attached target group is a group of targets that is attached to a load balancer. Structure is documented below.

    createdAt String

    Creation timestamp of this network load balancer.

    description String

    Description of the network load balancer.

    folderId String
    id String

    The provider-assigned unique ID for this managed resource.

    labels Map<String>

    Labels to assign to this network load balancer.

    listeners List<Property Map>

    Listener specification that will be used by a network load balancer. Structure is documented below.

    name String

    Name of the listener.

    networkLoadBalancerId String
    regionId String

    ID of the region where the network load balancer resides.

    type String

    Type of the network load balancer.

    Supporting Types

    GetLbNetworkLoadBalancerAttachedTargetGroup

    Healthchecks List<GetLbNetworkLoadBalancerAttachedTargetGroupHealthcheck>
    TargetGroupId string

    ID of the target group that attached to the network load balancer.

    • healthcheck.0.name - Name of the health check.
    • healthcheck.0.interval - The interval between health checks.
    • healthcheck.0.timeout - Timeout for a target to return a response for the health check.
    • healthcheck.0.unhealthy_threshold - Number of failed health checks before changing the status to UNHEALTHY.
    • healthcheck.0.healthy_threshold - Number of successful health checks required in order to set the HEALTHY status for the target.
    • healthcheck.0.tcp_options.0.port - Port to use for TCP health checks.
    • healthcheck.0.http_options.0.port - Port to use for HTTP health checks.
    • healthcheck.0.http_options.0.path - URL path to use for HTTP health checks.
    Healthchecks []GetLbNetworkLoadBalancerAttachedTargetGroupHealthcheck
    TargetGroupId string

    ID of the target group that attached to the network load balancer.

    • healthcheck.0.name - Name of the health check.
    • healthcheck.0.interval - The interval between health checks.
    • healthcheck.0.timeout - Timeout for a target to return a response for the health check.
    • healthcheck.0.unhealthy_threshold - Number of failed health checks before changing the status to UNHEALTHY.
    • healthcheck.0.healthy_threshold - Number of successful health checks required in order to set the HEALTHY status for the target.
    • healthcheck.0.tcp_options.0.port - Port to use for TCP health checks.
    • healthcheck.0.http_options.0.port - Port to use for HTTP health checks.
    • healthcheck.0.http_options.0.path - URL path to use for HTTP health checks.
    healthchecks List<GetLbNetworkLoadBalancerAttachedTargetGroupHealthcheck>
    targetGroupId String

    ID of the target group that attached to the network load balancer.

    • healthcheck.0.name - Name of the health check.
    • healthcheck.0.interval - The interval between health checks.
    • healthcheck.0.timeout - Timeout for a target to return a response for the health check.
    • healthcheck.0.unhealthy_threshold - Number of failed health checks before changing the status to UNHEALTHY.
    • healthcheck.0.healthy_threshold - Number of successful health checks required in order to set the HEALTHY status for the target.
    • healthcheck.0.tcp_options.0.port - Port to use for TCP health checks.
    • healthcheck.0.http_options.0.port - Port to use for HTTP health checks.
    • healthcheck.0.http_options.0.path - URL path to use for HTTP health checks.
    healthchecks GetLbNetworkLoadBalancerAttachedTargetGroupHealthcheck[]
    targetGroupId string

    ID of the target group that attached to the network load balancer.

    • healthcheck.0.name - Name of the health check.
    • healthcheck.0.interval - The interval between health checks.
    • healthcheck.0.timeout - Timeout for a target to return a response for the health check.
    • healthcheck.0.unhealthy_threshold - Number of failed health checks before changing the status to UNHEALTHY.
    • healthcheck.0.healthy_threshold - Number of successful health checks required in order to set the HEALTHY status for the target.
    • healthcheck.0.tcp_options.0.port - Port to use for TCP health checks.
    • healthcheck.0.http_options.0.port - Port to use for HTTP health checks.
    • healthcheck.0.http_options.0.path - URL path to use for HTTP health checks.
    healthchecks Sequence[GetLbNetworkLoadBalancerAttachedTargetGroupHealthcheck]
    target_group_id str

    ID of the target group that attached to the network load balancer.

    • healthcheck.0.name - Name of the health check.
    • healthcheck.0.interval - The interval between health checks.
    • healthcheck.0.timeout - Timeout for a target to return a response for the health check.
    • healthcheck.0.unhealthy_threshold - Number of failed health checks before changing the status to UNHEALTHY.
    • healthcheck.0.healthy_threshold - Number of successful health checks required in order to set the HEALTHY status for the target.
    • healthcheck.0.tcp_options.0.port - Port to use for TCP health checks.
    • healthcheck.0.http_options.0.port - Port to use for HTTP health checks.
    • healthcheck.0.http_options.0.path - URL path to use for HTTP health checks.
    healthchecks List<Property Map>
    targetGroupId String

    ID of the target group that attached to the network load balancer.

    • healthcheck.0.name - Name of the health check.
    • healthcheck.0.interval - The interval between health checks.
    • healthcheck.0.timeout - Timeout for a target to return a response for the health check.
    • healthcheck.0.unhealthy_threshold - Number of failed health checks before changing the status to UNHEALTHY.
    • healthcheck.0.healthy_threshold - Number of successful health checks required in order to set the HEALTHY status for the target.
    • healthcheck.0.tcp_options.0.port - Port to use for TCP health checks.
    • healthcheck.0.http_options.0.port - Port to use for HTTP health checks.
    • healthcheck.0.http_options.0.path - URL path to use for HTTP health checks.

    GetLbNetworkLoadBalancerAttachedTargetGroupHealthcheck

    GetLbNetworkLoadBalancerAttachedTargetGroupHealthcheckHttpOption

    Path string
    Port int

    Port for incoming traffic.

    Path string
    Port int

    Port for incoming traffic.

    path String
    port Integer

    Port for incoming traffic.

    path string
    port number

    Port for incoming traffic.

    path str
    port int

    Port for incoming traffic.

    path String
    port Number

    Port for incoming traffic.

    GetLbNetworkLoadBalancerAttachedTargetGroupHealthcheckTcpOption

    Port int

    Port for incoming traffic.

    Port int

    Port for incoming traffic.

    port Integer

    Port for incoming traffic.

    port number

    Port for incoming traffic.

    port int

    Port for incoming traffic.

    port Number

    Port for incoming traffic.

    GetLbNetworkLoadBalancerListener

    ExternalAddressSpecs List<GetLbNetworkLoadBalancerListenerExternalAddressSpec>
    InternalAddressSpecs List<GetLbNetworkLoadBalancerListenerInternalAddressSpec>
    Name string
    • Name of the network load balancer.
    Port int

    Port for incoming traffic.

    Protocol string

    Protocol for incoming traffic.

    TargetPort int

    Port of a target.

    • external_address_spec.0.address - External IP address of a listener.
    • external_address_spec.0.ip_version - IP version of the external addresses.
    • internal_address_spec.0.subnet_id - Subnet ID to which the internal IP address belongs
    • internal_address_spec.0.address - Internal IP address of a listener.
    • internal_address_spec.0.ip_version - IP version of the internal addresses.
    ExternalAddressSpecs []GetLbNetworkLoadBalancerListenerExternalAddressSpec
    InternalAddressSpecs []GetLbNetworkLoadBalancerListenerInternalAddressSpec
    Name string
    • Name of the network load balancer.
    Port int

    Port for incoming traffic.

    Protocol string

    Protocol for incoming traffic.

    TargetPort int

    Port of a target.

    • external_address_spec.0.address - External IP address of a listener.
    • external_address_spec.0.ip_version - IP version of the external addresses.
    • internal_address_spec.0.subnet_id - Subnet ID to which the internal IP address belongs
    • internal_address_spec.0.address - Internal IP address of a listener.
    • internal_address_spec.0.ip_version - IP version of the internal addresses.
    externalAddressSpecs List<GetLbNetworkLoadBalancerListenerExternalAddressSpec>
    internalAddressSpecs List<GetLbNetworkLoadBalancerListenerInternalAddressSpec>
    name String
    • Name of the network load balancer.
    port Integer

    Port for incoming traffic.

    protocol String

    Protocol for incoming traffic.

    targetPort Integer

    Port of a target.

    • external_address_spec.0.address - External IP address of a listener.
    • external_address_spec.0.ip_version - IP version of the external addresses.
    • internal_address_spec.0.subnet_id - Subnet ID to which the internal IP address belongs
    • internal_address_spec.0.address - Internal IP address of a listener.
    • internal_address_spec.0.ip_version - IP version of the internal addresses.
    externalAddressSpecs GetLbNetworkLoadBalancerListenerExternalAddressSpec[]
    internalAddressSpecs GetLbNetworkLoadBalancerListenerInternalAddressSpec[]
    name string
    • Name of the network load balancer.
    port number

    Port for incoming traffic.

    protocol string

    Protocol for incoming traffic.

    targetPort number

    Port of a target.

    • external_address_spec.0.address - External IP address of a listener.
    • external_address_spec.0.ip_version - IP version of the external addresses.
    • internal_address_spec.0.subnet_id - Subnet ID to which the internal IP address belongs
    • internal_address_spec.0.address - Internal IP address of a listener.
    • internal_address_spec.0.ip_version - IP version of the internal addresses.
    external_address_specs Sequence[GetLbNetworkLoadBalancerListenerExternalAddressSpec]
    internal_address_specs Sequence[GetLbNetworkLoadBalancerListenerInternalAddressSpec]
    name str
    • Name of the network load balancer.
    port int

    Port for incoming traffic.

    protocol str

    Protocol for incoming traffic.

    target_port int

    Port of a target.

    • external_address_spec.0.address - External IP address of a listener.
    • external_address_spec.0.ip_version - IP version of the external addresses.
    • internal_address_spec.0.subnet_id - Subnet ID to which the internal IP address belongs
    • internal_address_spec.0.address - Internal IP address of a listener.
    • internal_address_spec.0.ip_version - IP version of the internal addresses.
    externalAddressSpecs List<Property Map>
    internalAddressSpecs List<Property Map>
    name String
    • Name of the network load balancer.
    port Number

    Port for incoming traffic.

    protocol String

    Protocol for incoming traffic.

    targetPort Number

    Port of a target.

    • external_address_spec.0.address - External IP address of a listener.
    • external_address_spec.0.ip_version - IP version of the external addresses.
    • internal_address_spec.0.subnet_id - Subnet ID to which the internal IP address belongs
    • internal_address_spec.0.address - Internal IP address of a listener.
    • internal_address_spec.0.ip_version - IP version of the internal addresses.

    GetLbNetworkLoadBalancerListenerExternalAddressSpec

    Address string
    IpVersion string
    Address string
    IpVersion string
    address String
    ipVersion String
    address string
    ipVersion string
    address String
    ipVersion String

    GetLbNetworkLoadBalancerListenerInternalAddressSpec

    Address string
    IpVersion string
    SubnetId string
    Address string
    IpVersion string
    SubnetId string
    address String
    ipVersion String
    subnetId String
    address string
    ipVersion string
    subnetId string
    address String
    ipVersion String
    subnetId String

    Package Details

    Repository
    Yandex pulumi/pulumi-yandex
    License
    Apache-2.0
    Notes

    This Pulumi package is based on the yandex Terraform Provider.

    yandex logo
    Yandex v0.13.0 published on Tuesday, Feb 22, 2022 by Pulumi