1. Packages
  2. Gcore Provider
  3. API Docs
  4. CloudLoadBalancer
Viewing docs for gcore 2.0.0-alpha.3
published on Monday, Mar 30, 2026 by g-core
Viewing docs for gcore 2.0.0-alpha.3
published on Monday, Mar 30, 2026 by g-core

    Load balancers distribute incoming traffic across multiple instances with support for listeners, pools, and health monitoring.

    Example Usage

    Public load balancer

    Creates a public load balancer with a public VIP address.

    import * as pulumi from "@pulumi/pulumi";
    import * as gcore from "@pulumi/gcore";
    
    const publicLb = new gcore.CloudLoadBalancer("public_lb", {
        projectId: 1,
        regionId: 1,
        name: "My first public load balancer",
        flavor: "lb1-1-2",
        tags: {
            managed_by: "terraform",
        },
    });
    export const publicLbIp = publicLb.vipAddress;
    
    import pulumi
    import pulumi_gcore as gcore
    
    public_lb = gcore.CloudLoadBalancer("public_lb",
        project_id=1,
        region_id=1,
        name="My first public load balancer",
        flavor="lb1-1-2",
        tags={
            "managed_by": "terraform",
        })
    pulumi.export("publicLbIp", public_lb.vip_address)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/v2/gcore"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		publicLb, err := gcore.NewCloudLoadBalancer(ctx, "public_lb", &gcore.CloudLoadBalancerArgs{
    			ProjectId: pulumi.Float64(1),
    			RegionId:  pulumi.Float64(1),
    			Name:      pulumi.String("My first public load balancer"),
    			Flavor:    pulumi.String("lb1-1-2"),
    			Tags: pulumi.StringMap{
    				"managed_by": pulumi.String("terraform"),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		ctx.Export("publicLbIp", publicLb.VipAddress)
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Gcore = Pulumi.Gcore;
    
    return await Deployment.RunAsync(() => 
    {
        var publicLb = new Gcore.CloudLoadBalancer("public_lb", new()
        {
            ProjectId = 1,
            RegionId = 1,
            Name = "My first public load balancer",
            Flavor = "lb1-1-2",
            Tags = 
            {
                { "managed_by", "terraform" },
            },
        });
    
        return new Dictionary<string, object?>
        {
            ["publicLbIp"] = publicLb.VipAddress,
        };
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.gcore.CloudLoadBalancer;
    import com.pulumi.gcore.CloudLoadBalancerArgs;
    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) {
            var publicLb = new CloudLoadBalancer("publicLb", CloudLoadBalancerArgs.builder()
                .projectId(1.0)
                .regionId(1.0)
                .name("My first public load balancer")
                .flavor("lb1-1-2")
                .tags(Map.of("managed_by", "terraform"))
                .build());
    
            ctx.export("publicLbIp", publicLb.vipAddress());
        }
    }
    
    resources:
      publicLb:
        type: gcore:CloudLoadBalancer
        name: public_lb
        properties:
          projectId: 1
          regionId: 1
          name: My first public load balancer
          flavor: lb1-1-2
          tags:
            managed_by: terraform
    outputs:
      publicLbIp: ${publicLb.vipAddress}
    

    Public load balancer with reserved fixed IP

    Attaches a pre-allocated reserved fixed IP so the VIP address survives destroy/recreate cycles.

    import * as pulumi from "@pulumi/pulumi";
    import * as gcore from "@pulumi/gcore";
    
    export = async () => {
        // After destroying the load balancer, you can attach the Reserved Fixed IP to another load balancer or instance
        const publicLbFixedIp = new gcore.CloudReservedFixedIp("public_lb_fixed_ip", {
            projectId: 1,
            regionId: 1,
            isVip: false,
            type: "external",
        });
        const publicLbWithFixedIp = new gcore.CloudLoadBalancer("public_lb_with_fixed_ip", {
            projectId: 1,
            regionId: 1,
            name: "My first public load balancer with reserved fixed ip",
            flavor: "lb1-1-2",
            vipPortId: publicLbFixedIp.portId,
        });
        return {
            publicLbWithFixedIp: publicLbWithFixedIp.vipAddress,
        };
    }
    
    import pulumi
    import pulumi_gcore as gcore
    
    # After destroying the load balancer, you can attach the Reserved Fixed IP to another load balancer or instance
    public_lb_fixed_ip = gcore.CloudReservedFixedIp("public_lb_fixed_ip",
        project_id=1,
        region_id=1,
        is_vip=False,
        type="external")
    public_lb_with_fixed_ip = gcore.CloudLoadBalancer("public_lb_with_fixed_ip",
        project_id=1,
        region_id=1,
        name="My first public load balancer with reserved fixed ip",
        flavor="lb1-1-2",
        vip_port_id=public_lb_fixed_ip.port_id)
    pulumi.export("publicLbWithFixedIp", public_lb_with_fixed_ip.vip_address)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/v2/gcore"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// After destroying the load balancer, you can attach the Reserved Fixed IP to another load balancer or instance
    		publicLbFixedIp, err := gcore.NewCloudReservedFixedIp(ctx, "public_lb_fixed_ip", &gcore.CloudReservedFixedIpArgs{
    			ProjectId: pulumi.Float64(1),
    			RegionId:  pulumi.Float64(1),
    			IsVip:     pulumi.Bool(false),
    			Type:      pulumi.String("external"),
    		})
    		if err != nil {
    			return err
    		}
    		publicLbWithFixedIp, err := gcore.NewCloudLoadBalancer(ctx, "public_lb_with_fixed_ip", &gcore.CloudLoadBalancerArgs{
    			ProjectId: pulumi.Float64(1),
    			RegionId:  pulumi.Float64(1),
    			Name:      pulumi.String("My first public load balancer with reserved fixed ip"),
    			Flavor:    pulumi.String("lb1-1-2"),
    			VipPortId: publicLbFixedIp.PortId,
    		})
    		if err != nil {
    			return err
    		}
    		ctx.Export("publicLbWithFixedIp", publicLbWithFixedIp.VipAddress)
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Gcore = Pulumi.Gcore;
    
    return await Deployment.RunAsync(() => 
    {
        // After destroying the load balancer, you can attach the Reserved Fixed IP to another load balancer or instance
        var publicLbFixedIp = new Gcore.CloudReservedFixedIp("public_lb_fixed_ip", new()
        {
            ProjectId = 1,
            RegionId = 1,
            IsVip = false,
            Type = "external",
        });
    
        var publicLbWithFixedIp = new Gcore.CloudLoadBalancer("public_lb_with_fixed_ip", new()
        {
            ProjectId = 1,
            RegionId = 1,
            Name = "My first public load balancer with reserved fixed ip",
            Flavor = "lb1-1-2",
            VipPortId = publicLbFixedIp.PortId,
        });
    
        return new Dictionary<string, object?>
        {
            ["publicLbWithFixedIp"] = publicLbWithFixedIp.VipAddress,
        };
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.gcore.CloudReservedFixedIp;
    import com.pulumi.gcore.CloudReservedFixedIpArgs;
    import com.pulumi.gcore.CloudLoadBalancer;
    import com.pulumi.gcore.CloudLoadBalancerArgs;
    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) {
            // After destroying the load balancer, you can attach the Reserved Fixed IP to another load balancer or instance
            var publicLbFixedIp = new CloudReservedFixedIp("publicLbFixedIp", CloudReservedFixedIpArgs.builder()
                .projectId(1.0)
                .regionId(1.0)
                .isVip(false)
                .type("external")
                .build());
    
            var publicLbWithFixedIp = new CloudLoadBalancer("publicLbWithFixedIp", CloudLoadBalancerArgs.builder()
                .projectId(1.0)
                .regionId(1.0)
                .name("My first public load balancer with reserved fixed ip")
                .flavor("lb1-1-2")
                .vipPortId(publicLbFixedIp.portId())
                .build());
    
            ctx.export("publicLbWithFixedIp", publicLbWithFixedIp.vipAddress());
        }
    }
    
    resources:
      # After destroying the load balancer, you can attach the Reserved Fixed IP to another load balancer or instance
      publicLbFixedIp:
        type: gcore:CloudReservedFixedIp
        name: public_lb_fixed_ip
        properties:
          projectId: 1
          regionId: 1
          isVip: false
          type: external
      publicLbWithFixedIp:
        type: gcore:CloudLoadBalancer
        name: public_lb_with_fixed_ip
        properties:
          projectId: 1
          regionId: 1
          name: My first public load balancer with reserved fixed ip
          flavor: lb1-1-2
          vipPortId: ${publicLbFixedIp.portId}
    outputs:
      publicLbWithFixedIp: ${publicLbWithFixedIp.vipAddress}
    

    Private load balancer

    Creates a load balancer on a private network with no public IP.

    import * as pulumi from "@pulumi/pulumi";
    import * as gcore from "@pulumi/gcore";
    
    const privateNetwork = new gcore.CloudNetwork("private_network", {
        projectId: 1,
        regionId: 1,
        name: "my-private-network",
    });
    const privateSubnet = new gcore.CloudNetworkSubnet("private_subnet", {
        projectId: 1,
        regionId: 1,
        cidr: "10.0.0.0/24",
        name: "my-private-network-subnet",
        networkId: privateNetwork.id,
    });
    const privateLb = new gcore.CloudLoadBalancer("private_lb", {
        projectId: 1,
        regionId: 1,
        name: "My first private load balancer",
        flavor: "lb1-1-2",
        vipNetworkId: privateNetwork.id,
        vipSubnetId: privateSubnet.id,
    });
    export const privateLbIp = privateLb.vipAddress;
    
    import pulumi
    import pulumi_gcore as gcore
    
    private_network = gcore.CloudNetwork("private_network",
        project_id=1,
        region_id=1,
        name="my-private-network")
    private_subnet = gcore.CloudNetworkSubnet("private_subnet",
        project_id=1,
        region_id=1,
        cidr="10.0.0.0/24",
        name="my-private-network-subnet",
        network_id=private_network.id)
    private_lb = gcore.CloudLoadBalancer("private_lb",
        project_id=1,
        region_id=1,
        name="My first private load balancer",
        flavor="lb1-1-2",
        vip_network_id=private_network.id,
        vip_subnet_id=private_subnet.id)
    pulumi.export("privateLbIp", private_lb.vip_address)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/v2/gcore"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		privateNetwork, err := gcore.NewCloudNetwork(ctx, "private_network", &gcore.CloudNetworkArgs{
    			ProjectId: pulumi.Float64(1),
    			RegionId:  pulumi.Float64(1),
    			Name:      pulumi.String("my-private-network"),
    		})
    		if err != nil {
    			return err
    		}
    		privateSubnet, err := gcore.NewCloudNetworkSubnet(ctx, "private_subnet", &gcore.CloudNetworkSubnetArgs{
    			ProjectId: pulumi.Float64(1),
    			RegionId:  pulumi.Float64(1),
    			Cidr:      pulumi.String("10.0.0.0/24"),
    			Name:      pulumi.String("my-private-network-subnet"),
    			NetworkId: privateNetwork.ID(),
    		})
    		if err != nil {
    			return err
    		}
    		privateLb, err := gcore.NewCloudLoadBalancer(ctx, "private_lb", &gcore.CloudLoadBalancerArgs{
    			ProjectId:    pulumi.Float64(1),
    			RegionId:     pulumi.Float64(1),
    			Name:         pulumi.String("My first private load balancer"),
    			Flavor:       pulumi.String("lb1-1-2"),
    			VipNetworkId: privateNetwork.ID(),
    			VipSubnetId:  privateSubnet.ID(),
    		})
    		if err != nil {
    			return err
    		}
    		ctx.Export("privateLbIp", privateLb.VipAddress)
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Gcore = Pulumi.Gcore;
    
    return await Deployment.RunAsync(() => 
    {
        var privateNetwork = new Gcore.CloudNetwork("private_network", new()
        {
            ProjectId = 1,
            RegionId = 1,
            Name = "my-private-network",
        });
    
        var privateSubnet = new Gcore.CloudNetworkSubnet("private_subnet", new()
        {
            ProjectId = 1,
            RegionId = 1,
            Cidr = "10.0.0.0/24",
            Name = "my-private-network-subnet",
            NetworkId = privateNetwork.Id,
        });
    
        var privateLb = new Gcore.CloudLoadBalancer("private_lb", new()
        {
            ProjectId = 1,
            RegionId = 1,
            Name = "My first private load balancer",
            Flavor = "lb1-1-2",
            VipNetworkId = privateNetwork.Id,
            VipSubnetId = privateSubnet.Id,
        });
    
        return new Dictionary<string, object?>
        {
            ["privateLbIp"] = privateLb.VipAddress,
        };
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.gcore.CloudNetwork;
    import com.pulumi.gcore.CloudNetworkArgs;
    import com.pulumi.gcore.CloudNetworkSubnet;
    import com.pulumi.gcore.CloudNetworkSubnetArgs;
    import com.pulumi.gcore.CloudLoadBalancer;
    import com.pulumi.gcore.CloudLoadBalancerArgs;
    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) {
            var privateNetwork = new CloudNetwork("privateNetwork", CloudNetworkArgs.builder()
                .projectId(1.0)
                .regionId(1.0)
                .name("my-private-network")
                .build());
    
            var privateSubnet = new CloudNetworkSubnet("privateSubnet", CloudNetworkSubnetArgs.builder()
                .projectId(1.0)
                .regionId(1.0)
                .cidr("10.0.0.0/24")
                .name("my-private-network-subnet")
                .networkId(privateNetwork.id())
                .build());
    
            var privateLb = new CloudLoadBalancer("privateLb", CloudLoadBalancerArgs.builder()
                .projectId(1.0)
                .regionId(1.0)
                .name("My first private load balancer")
                .flavor("lb1-1-2")
                .vipNetworkId(privateNetwork.id())
                .vipSubnetId(privateSubnet.id())
                .build());
    
            ctx.export("privateLbIp", privateLb.vipAddress());
        }
    }
    
    resources:
      privateNetwork:
        type: gcore:CloudNetwork
        name: private_network
        properties:
          projectId: 1
          regionId: 1
          name: my-private-network
      privateSubnet:
        type: gcore:CloudNetworkSubnet
        name: private_subnet
        properties:
          projectId: 1
          regionId: 1
          cidr: 10.0.0.0/24
          name: my-private-network-subnet
          networkId: ${privateNetwork.id}
      privateLb:
        type: gcore:CloudLoadBalancer
        name: private_lb
        properties:
          projectId: 1
          regionId: 1
          name: My first private load balancer
          flavor: lb1-1-2
          vipNetworkId: ${privateNetwork.id}
          vipSubnetId: ${privateSubnet.id}
    outputs:
      privateLbIp: ${privateLb.vipAddress}
    

    Private load balancer in dual-stack mode

    Creates a private load balancer with both IPv4 and IPv6 subnets.

    import * as pulumi from "@pulumi/pulumi";
    import * as gcore from "@pulumi/gcore";
    
    const privateNetworkDualstack = new gcore.CloudNetwork("private_network_dualstack", {
        projectId: 1,
        regionId: 1,
        name: "my-private-network-dualstack",
    });
    const privateSubnetIpv4 = new gcore.CloudNetworkSubnet("private_subnet_ipv4", {
        projectId: 1,
        regionId: 1,
        cidr: "10.0.0.0/24",
        name: "my-private-network-subnet-ipv4",
        networkId: privateNetworkDualstack.id,
    });
    const privateSubnetIpv6 = new gcore.CloudNetworkSubnet("private_subnet_ipv6", {
        projectId: 1,
        regionId: 1,
        cidr: "fd00::/120",
        name: "my-private-network-subnet-ipv6",
        networkId: privateNetworkDualstack.id,
    });
    const privateLbDualstack = new gcore.CloudLoadBalancer("private_lb_dualstack", {
        projectId: 1,
        regionId: 1,
        name: "My first private dual stack load balancer",
        flavor: "lb1-1-2",
        vipNetworkId: privateNetworkDualstack.id,
        vipIpFamily: "dual",
    }, {
        dependsOn: [
            privateSubnetIpv4,
            privateSubnetIpv6,
        ],
    });
    
    import pulumi
    import pulumi_gcore as gcore
    
    private_network_dualstack = gcore.CloudNetwork("private_network_dualstack",
        project_id=1,
        region_id=1,
        name="my-private-network-dualstack")
    private_subnet_ipv4 = gcore.CloudNetworkSubnet("private_subnet_ipv4",
        project_id=1,
        region_id=1,
        cidr="10.0.0.0/24",
        name="my-private-network-subnet-ipv4",
        network_id=private_network_dualstack.id)
    private_subnet_ipv6 = gcore.CloudNetworkSubnet("private_subnet_ipv6",
        project_id=1,
        region_id=1,
        cidr="fd00::/120",
        name="my-private-network-subnet-ipv6",
        network_id=private_network_dualstack.id)
    private_lb_dualstack = gcore.CloudLoadBalancer("private_lb_dualstack",
        project_id=1,
        region_id=1,
        name="My first private dual stack load balancer",
        flavor="lb1-1-2",
        vip_network_id=private_network_dualstack.id,
        vip_ip_family="dual",
        opts = pulumi.ResourceOptions(depends_on=[
                private_subnet_ipv4,
                private_subnet_ipv6,
            ]))
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/v2/gcore"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		privateNetworkDualstack, err := gcore.NewCloudNetwork(ctx, "private_network_dualstack", &gcore.CloudNetworkArgs{
    			ProjectId: pulumi.Float64(1),
    			RegionId:  pulumi.Float64(1),
    			Name:      pulumi.String("my-private-network-dualstack"),
    		})
    		if err != nil {
    			return err
    		}
    		privateSubnetIpv4, err := gcore.NewCloudNetworkSubnet(ctx, "private_subnet_ipv4", &gcore.CloudNetworkSubnetArgs{
    			ProjectId: pulumi.Float64(1),
    			RegionId:  pulumi.Float64(1),
    			Cidr:      pulumi.String("10.0.0.0/24"),
    			Name:      pulumi.String("my-private-network-subnet-ipv4"),
    			NetworkId: privateNetworkDualstack.ID(),
    		})
    		if err != nil {
    			return err
    		}
    		privateSubnetIpv6, err := gcore.NewCloudNetworkSubnet(ctx, "private_subnet_ipv6", &gcore.CloudNetworkSubnetArgs{
    			ProjectId: pulumi.Float64(1),
    			RegionId:  pulumi.Float64(1),
    			Cidr:      pulumi.String("fd00::/120"),
    			Name:      pulumi.String("my-private-network-subnet-ipv6"),
    			NetworkId: privateNetworkDualstack.ID(),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = gcore.NewCloudLoadBalancer(ctx, "private_lb_dualstack", &gcore.CloudLoadBalancerArgs{
    			ProjectId:    pulumi.Float64(1),
    			RegionId:     pulumi.Float64(1),
    			Name:         pulumi.String("My first private dual stack load balancer"),
    			Flavor:       pulumi.String("lb1-1-2"),
    			VipNetworkId: privateNetworkDualstack.ID(),
    			VipIpFamily:  pulumi.String("dual"),
    		}, pulumi.DependsOn([]pulumi.Resource{
    			privateSubnetIpv4,
    			privateSubnetIpv6,
    		}))
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Gcore = Pulumi.Gcore;
    
    return await Deployment.RunAsync(() => 
    {
        var privateNetworkDualstack = new Gcore.CloudNetwork("private_network_dualstack", new()
        {
            ProjectId = 1,
            RegionId = 1,
            Name = "my-private-network-dualstack",
        });
    
        var privateSubnetIpv4 = new Gcore.CloudNetworkSubnet("private_subnet_ipv4", new()
        {
            ProjectId = 1,
            RegionId = 1,
            Cidr = "10.0.0.0/24",
            Name = "my-private-network-subnet-ipv4",
            NetworkId = privateNetworkDualstack.Id,
        });
    
        var privateSubnetIpv6 = new Gcore.CloudNetworkSubnet("private_subnet_ipv6", new()
        {
            ProjectId = 1,
            RegionId = 1,
            Cidr = "fd00::/120",
            Name = "my-private-network-subnet-ipv6",
            NetworkId = privateNetworkDualstack.Id,
        });
    
        var privateLbDualstack = new Gcore.CloudLoadBalancer("private_lb_dualstack", new()
        {
            ProjectId = 1,
            RegionId = 1,
            Name = "My first private dual stack load balancer",
            Flavor = "lb1-1-2",
            VipNetworkId = privateNetworkDualstack.Id,
            VipIpFamily = "dual",
        }, new CustomResourceOptions
        {
            DependsOn =
            {
                privateSubnetIpv4,
                privateSubnetIpv6,
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.gcore.CloudNetwork;
    import com.pulumi.gcore.CloudNetworkArgs;
    import com.pulumi.gcore.CloudNetworkSubnet;
    import com.pulumi.gcore.CloudNetworkSubnetArgs;
    import com.pulumi.gcore.CloudLoadBalancer;
    import com.pulumi.gcore.CloudLoadBalancerArgs;
    import com.pulumi.resources.CustomResourceOptions;
    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) {
            var privateNetworkDualstack = new CloudNetwork("privateNetworkDualstack", CloudNetworkArgs.builder()
                .projectId(1.0)
                .regionId(1.0)
                .name("my-private-network-dualstack")
                .build());
    
            var privateSubnetIpv4 = new CloudNetworkSubnet("privateSubnetIpv4", CloudNetworkSubnetArgs.builder()
                .projectId(1.0)
                .regionId(1.0)
                .cidr("10.0.0.0/24")
                .name("my-private-network-subnet-ipv4")
                .networkId(privateNetworkDualstack.id())
                .build());
    
            var privateSubnetIpv6 = new CloudNetworkSubnet("privateSubnetIpv6", CloudNetworkSubnetArgs.builder()
                .projectId(1.0)
                .regionId(1.0)
                .cidr("fd00::/120")
                .name("my-private-network-subnet-ipv6")
                .networkId(privateNetworkDualstack.id())
                .build());
    
            var privateLbDualstack = new CloudLoadBalancer("privateLbDualstack", CloudLoadBalancerArgs.builder()
                .projectId(1.0)
                .regionId(1.0)
                .name("My first private dual stack load balancer")
                .flavor("lb1-1-2")
                .vipNetworkId(privateNetworkDualstack.id())
                .vipIpFamily("dual")
                .build(), CustomResourceOptions.builder()
                    .dependsOn(                
                        privateSubnetIpv4,
                        privateSubnetIpv6)
                    .build());
    
        }
    }
    
    resources:
      privateNetworkDualstack:
        type: gcore:CloudNetwork
        name: private_network_dualstack
        properties:
          projectId: 1
          regionId: 1
          name: my-private-network-dualstack
      privateSubnetIpv4:
        type: gcore:CloudNetworkSubnet
        name: private_subnet_ipv4
        properties:
          projectId: 1
          regionId: 1
          cidr: 10.0.0.0/24
          name: my-private-network-subnet-ipv4
          networkId: ${privateNetworkDualstack.id}
      privateSubnetIpv6:
        type: gcore:CloudNetworkSubnet
        name: private_subnet_ipv6
        properties:
          projectId: 1
          regionId: 1
          cidr: fd00::/120
          name: my-private-network-subnet-ipv6
          networkId: ${privateNetworkDualstack.id}
      privateLbDualstack:
        type: gcore:CloudLoadBalancer
        name: private_lb_dualstack
        properties:
          projectId: 1
          regionId: 1
          name: My first private dual stack load balancer
          flavor: lb1-1-2
          vipNetworkId: ${privateNetworkDualstack.id}
          vipIpFamily: dual
        options:
          dependsOn:
            - ${privateSubnetIpv4}
            - ${privateSubnetIpv6}
    

    Floating IP for a private load balancer

    Associates a floating IP with an existing private load balancer to provide public access.

    import * as pulumi from "@pulumi/pulumi";
    import * as gcore from "@pulumi/gcore";
    
    export = async () => {
        const privateLbFip = new gcore.CloudFloatingIp("private_lb_fip", {
            projectId: 1,
            regionId: 1,
            fixedIpAddress: privateLb.vipAddress,
            portId: privateLb.vipPortId,
        });
        return {
            privateLbFip: privateLbFip.floatingIpAddress,
        };
    }
    
    import pulumi
    import pulumi_gcore as gcore
    
    private_lb_fip = gcore.CloudFloatingIp("private_lb_fip",
        project_id=1,
        region_id=1,
        fixed_ip_address=private_lb["vipAddress"],
        port_id=private_lb["vipPortId"])
    pulumi.export("privateLbFip", private_lb_fip.floating_ip_address)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/v2/gcore"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		privateLbFip, err := gcore.NewCloudFloatingIp(ctx, "private_lb_fip", &gcore.CloudFloatingIpArgs{
    			ProjectId:      pulumi.Float64(1),
    			RegionId:       pulumi.Float64(1),
    			FixedIpAddress: pulumi.Any(privateLb.VipAddress),
    			PortId:         pulumi.Any(privateLb.VipPortId),
    		})
    		if err != nil {
    			return err
    		}
    		ctx.Export("privateLbFip", privateLbFip.FloatingIpAddress)
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Gcore = Pulumi.Gcore;
    
    return await Deployment.RunAsync(() => 
    {
        var privateLbFip = new Gcore.CloudFloatingIp("private_lb_fip", new()
        {
            ProjectId = 1,
            RegionId = 1,
            FixedIpAddress = privateLb.VipAddress,
            PortId = privateLb.VipPortId,
        });
    
        return new Dictionary<string, object?>
        {
            ["privateLbFip"] = privateLbFip.FloatingIpAddress,
        };
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.gcore.CloudFloatingIp;
    import com.pulumi.gcore.CloudFloatingIpArgs;
    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) {
            var privateLbFip = new CloudFloatingIp("privateLbFip", CloudFloatingIpArgs.builder()
                .projectId(1.0)
                .regionId(1.0)
                .fixedIpAddress(privateLb.vipAddress())
                .portId(privateLb.vipPortId())
                .build());
    
            ctx.export("privateLbFip", privateLbFip.floatingIpAddress());
        }
    }
    
    resources:
      privateLbFip:
        type: gcore:CloudFloatingIp
        name: private_lb_fip
        properties:
          projectId: 1
          regionId: 1
          fixedIpAddress: ${privateLb.vipAddress}
          portId: ${privateLb.vipPortId}
    outputs:
      privateLbFip: ${privateLbFip.floatingIpAddress}
    

    Create CloudLoadBalancer Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new CloudLoadBalancer(name: string, args?: CloudLoadBalancerArgs, opts?: CustomResourceOptions);
    @overload
    def CloudLoadBalancer(resource_name: str,
                          args: Optional[CloudLoadBalancerArgs] = None,
                          opts: Optional[ResourceOptions] = None)
    
    @overload
    def CloudLoadBalancer(resource_name: str,
                          opts: Optional[ResourceOptions] = None,
                          flavor: Optional[str] = None,
                          floating_ip: Optional[CloudLoadBalancerFloatingIpArgs] = None,
                          logging: Optional[CloudLoadBalancerLoggingArgs] = None,
                          name: Optional[str] = None,
                          name_template: Optional[str] = None,
                          preferred_connectivity: Optional[str] = None,
                          project_id: Optional[float] = None,
                          region_id: Optional[float] = None,
                          tags: Optional[Mapping[str, str]] = None,
                          vip_ip_family: Optional[str] = None,
                          vip_network_id: Optional[str] = None,
                          vip_port_id: Optional[str] = None,
                          vip_subnet_id: Optional[str] = None)
    func NewCloudLoadBalancer(ctx *Context, name string, args *CloudLoadBalancerArgs, opts ...ResourceOption) (*CloudLoadBalancer, error)
    public CloudLoadBalancer(string name, CloudLoadBalancerArgs? args = null, CustomResourceOptions? opts = null)
    public CloudLoadBalancer(String name, CloudLoadBalancerArgs args)
    public CloudLoadBalancer(String name, CloudLoadBalancerArgs args, CustomResourceOptions options)
    
    type: gcore:CloudLoadBalancer
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args CloudLoadBalancerArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args CloudLoadBalancerArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args CloudLoadBalancerArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args CloudLoadBalancerArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args CloudLoadBalancerArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var cloudLoadBalancerResource = new Gcore.Index.CloudLoadBalancer("cloudLoadBalancerResource", new()
    {
        Flavor = "string",
        FloatingIp = new Gcore.Inputs.CloudLoadBalancerFloatingIpArgs
        {
            CreatedAt = "string",
            CreatorTaskId = "string",
            FixedIpAddress = "string",
            FloatingIpAddress = "string",
            Id = "string",
            PortId = "string",
            ProjectId = 0,
            Region = "string",
            RegionId = 0,
            RouterId = "string",
            Status = "string",
            Tags = new[]
            {
                new Gcore.Inputs.CloudLoadBalancerFloatingIpTagArgs
                {
                    Key = "string",
                    ReadOnly = false,
                    Value = "string",
                },
            },
            UpdatedAt = "string",
        },
        Logging = new Gcore.Inputs.CloudLoadBalancerLoggingArgs
        {
            DestinationRegionId = 0,
            Enabled = false,
            RetentionPolicy = new Gcore.Inputs.CloudLoadBalancerLoggingRetentionPolicyArgs
            {
                Period = 0,
            },
            TopicName = "string",
        },
        Name = "string",
        NameTemplate = "string",
        PreferredConnectivity = "string",
        ProjectId = 0,
        RegionId = 0,
        Tags = 
        {
            { "string", "string" },
        },
        VipIpFamily = "string",
        VipNetworkId = "string",
        VipPortId = "string",
        VipSubnetId = "string",
    });
    
    example, err := gcore.NewCloudLoadBalancer(ctx, "cloudLoadBalancerResource", &gcore.CloudLoadBalancerArgs{
    	Flavor: pulumi.String("string"),
    	FloatingIp: &gcore.CloudLoadBalancerFloatingIpArgs{
    		CreatedAt:         pulumi.String("string"),
    		CreatorTaskId:     pulumi.String("string"),
    		FixedIpAddress:    pulumi.String("string"),
    		FloatingIpAddress: pulumi.String("string"),
    		Id:                pulumi.String("string"),
    		PortId:            pulumi.String("string"),
    		ProjectId:         pulumi.Float64(0),
    		Region:            pulumi.String("string"),
    		RegionId:          pulumi.Float64(0),
    		RouterId:          pulumi.String("string"),
    		Status:            pulumi.String("string"),
    		Tags: gcore.CloudLoadBalancerFloatingIpTagArray{
    			&gcore.CloudLoadBalancerFloatingIpTagArgs{
    				Key:      pulumi.String("string"),
    				ReadOnly: pulumi.Bool(false),
    				Value:    pulumi.String("string"),
    			},
    		},
    		UpdatedAt: pulumi.String("string"),
    	},
    	Logging: &gcore.CloudLoadBalancerLoggingArgs{
    		DestinationRegionId: pulumi.Float64(0),
    		Enabled:             pulumi.Bool(false),
    		RetentionPolicy: &gcore.CloudLoadBalancerLoggingRetentionPolicyArgs{
    			Period: pulumi.Float64(0),
    		},
    		TopicName: pulumi.String("string"),
    	},
    	Name:                  pulumi.String("string"),
    	NameTemplate:          pulumi.String("string"),
    	PreferredConnectivity: pulumi.String("string"),
    	ProjectId:             pulumi.Float64(0),
    	RegionId:              pulumi.Float64(0),
    	Tags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	VipIpFamily:  pulumi.String("string"),
    	VipNetworkId: pulumi.String("string"),
    	VipPortId:    pulumi.String("string"),
    	VipSubnetId:  pulumi.String("string"),
    })
    
    var cloudLoadBalancerResource = new CloudLoadBalancer("cloudLoadBalancerResource", CloudLoadBalancerArgs.builder()
        .flavor("string")
        .floatingIp(CloudLoadBalancerFloatingIpArgs.builder()
            .createdAt("string")
            .creatorTaskId("string")
            .fixedIpAddress("string")
            .floatingIpAddress("string")
            .id("string")
            .portId("string")
            .projectId(0.0)
            .region("string")
            .regionId(0.0)
            .routerId("string")
            .status("string")
            .tags(CloudLoadBalancerFloatingIpTagArgs.builder()
                .key("string")
                .readOnly(false)
                .value("string")
                .build())
            .updatedAt("string")
            .build())
        .logging(CloudLoadBalancerLoggingArgs.builder()
            .destinationRegionId(0.0)
            .enabled(false)
            .retentionPolicy(CloudLoadBalancerLoggingRetentionPolicyArgs.builder()
                .period(0.0)
                .build())
            .topicName("string")
            .build())
        .name("string")
        .nameTemplate("string")
        .preferredConnectivity("string")
        .projectId(0.0)
        .regionId(0.0)
        .tags(Map.of("string", "string"))
        .vipIpFamily("string")
        .vipNetworkId("string")
        .vipPortId("string")
        .vipSubnetId("string")
        .build());
    
    cloud_load_balancer_resource = gcore.CloudLoadBalancer("cloudLoadBalancerResource",
        flavor="string",
        floating_ip={
            "created_at": "string",
            "creator_task_id": "string",
            "fixed_ip_address": "string",
            "floating_ip_address": "string",
            "id": "string",
            "port_id": "string",
            "project_id": 0,
            "region": "string",
            "region_id": 0,
            "router_id": "string",
            "status": "string",
            "tags": [{
                "key": "string",
                "read_only": False,
                "value": "string",
            }],
            "updated_at": "string",
        },
        logging={
            "destination_region_id": 0,
            "enabled": False,
            "retention_policy": {
                "period": 0,
            },
            "topic_name": "string",
        },
        name="string",
        name_template="string",
        preferred_connectivity="string",
        project_id=0,
        region_id=0,
        tags={
            "string": "string",
        },
        vip_ip_family="string",
        vip_network_id="string",
        vip_port_id="string",
        vip_subnet_id="string")
    
    const cloudLoadBalancerResource = new gcore.CloudLoadBalancer("cloudLoadBalancerResource", {
        flavor: "string",
        floatingIp: {
            createdAt: "string",
            creatorTaskId: "string",
            fixedIpAddress: "string",
            floatingIpAddress: "string",
            id: "string",
            portId: "string",
            projectId: 0,
            region: "string",
            regionId: 0,
            routerId: "string",
            status: "string",
            tags: [{
                key: "string",
                readOnly: false,
                value: "string",
            }],
            updatedAt: "string",
        },
        logging: {
            destinationRegionId: 0,
            enabled: false,
            retentionPolicy: {
                period: 0,
            },
            topicName: "string",
        },
        name: "string",
        nameTemplate: "string",
        preferredConnectivity: "string",
        projectId: 0,
        regionId: 0,
        tags: {
            string: "string",
        },
        vipIpFamily: "string",
        vipNetworkId: "string",
        vipPortId: "string",
        vipSubnetId: "string",
    });
    
    type: gcore:CloudLoadBalancer
    properties:
        flavor: string
        floatingIp:
            createdAt: string
            creatorTaskId: string
            fixedIpAddress: string
            floatingIpAddress: string
            id: string
            portId: string
            projectId: 0
            region: string
            regionId: 0
            routerId: string
            status: string
            tags:
                - key: string
                  readOnly: false
                  value: string
            updatedAt: string
        logging:
            destinationRegionId: 0
            enabled: false
            retentionPolicy:
                period: 0
            topicName: string
        name: string
        nameTemplate: string
        preferredConnectivity: string
        projectId: 0
        regionId: 0
        tags:
            string: string
        vipIpFamily: string
        vipNetworkId: string
        vipPortId: string
        vipSubnetId: string
    

    CloudLoadBalancer Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The CloudLoadBalancer resource accepts the following input properties:

    Flavor string
    Load balancer flavor name
    FloatingIp CloudLoadBalancerFloatingIp
    Floating IP configuration for assignment
    Logging CloudLoadBalancerLogging
    Logging configuration
    Name string
    Load balancer name. Either name or name_template should be specified.
    NameTemplate string
    Load balancer name which will be changed by template. Either name or name_template should be specified.
    PreferredConnectivity string
    Preferred option to establish connectivity between load balancer and its pools members. L2 provides best performance, L3 provides less IPs usage. It is taking effect only if instance_id + ip_address is provided, not subnet_id + ip_address, because we're considering this as intentional subnet_id specification. Available values: "L2", "L3".
    ProjectId double
    Project ID
    RegionId double
    Region ID
    Tags Dictionary<string, string>
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    VipIpFamily string
    IP family for load balancer subnet auto-selection if vip_network_id is specified Available values: "dual", "ipv4", "ipv6".
    VipNetworkId string
    Network ID for load balancer. If not specified, default external network will be used. Mutually exclusive with vip_port_id
    VipPortId string
    Existing Reserved Fixed IP port ID for load balancer. Mutually exclusive with vip_network_id
    VipSubnetId string
    Subnet ID for load balancer. If not specified, any subnet from vip_network_id will be selected. Ignored when vip_network_id is not specified.
    Flavor string
    Load balancer flavor name
    FloatingIp CloudLoadBalancerFloatingIpArgs
    Floating IP configuration for assignment
    Logging CloudLoadBalancerLoggingArgs
    Logging configuration
    Name string
    Load balancer name. Either name or name_template should be specified.
    NameTemplate string
    Load balancer name which will be changed by template. Either name or name_template should be specified.
    PreferredConnectivity string
    Preferred option to establish connectivity between load balancer and its pools members. L2 provides best performance, L3 provides less IPs usage. It is taking effect only if instance_id + ip_address is provided, not subnet_id + ip_address, because we're considering this as intentional subnet_id specification. Available values: "L2", "L3".
    ProjectId float64
    Project ID
    RegionId float64
    Region ID
    Tags map[string]string
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    VipIpFamily string
    IP family for load balancer subnet auto-selection if vip_network_id is specified Available values: "dual", "ipv4", "ipv6".
    VipNetworkId string
    Network ID for load balancer. If not specified, default external network will be used. Mutually exclusive with vip_port_id
    VipPortId string
    Existing Reserved Fixed IP port ID for load balancer. Mutually exclusive with vip_network_id
    VipSubnetId string
    Subnet ID for load balancer. If not specified, any subnet from vip_network_id will be selected. Ignored when vip_network_id is not specified.
    flavor String
    Load balancer flavor name
    floatingIp CloudLoadBalancerFloatingIp
    Floating IP configuration for assignment
    logging CloudLoadBalancerLogging
    Logging configuration
    name String
    Load balancer name. Either name or name_template should be specified.
    nameTemplate String
    Load balancer name which will be changed by template. Either name or name_template should be specified.
    preferredConnectivity String
    Preferred option to establish connectivity between load balancer and its pools members. L2 provides best performance, L3 provides less IPs usage. It is taking effect only if instance_id + ip_address is provided, not subnet_id + ip_address, because we're considering this as intentional subnet_id specification. Available values: "L2", "L3".
    projectId Double
    Project ID
    regionId Double
    Region ID
    tags Map<String,String>
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    vipIpFamily String
    IP family for load balancer subnet auto-selection if vip_network_id is specified Available values: "dual", "ipv4", "ipv6".
    vipNetworkId String
    Network ID for load balancer. If not specified, default external network will be used. Mutually exclusive with vip_port_id
    vipPortId String
    Existing Reserved Fixed IP port ID for load balancer. Mutually exclusive with vip_network_id
    vipSubnetId String
    Subnet ID for load balancer. If not specified, any subnet from vip_network_id will be selected. Ignored when vip_network_id is not specified.
    flavor string
    Load balancer flavor name
    floatingIp CloudLoadBalancerFloatingIp
    Floating IP configuration for assignment
    logging CloudLoadBalancerLogging
    Logging configuration
    name string
    Load balancer name. Either name or name_template should be specified.
    nameTemplate string
    Load balancer name which will be changed by template. Either name or name_template should be specified.
    preferredConnectivity string
    Preferred option to establish connectivity between load balancer and its pools members. L2 provides best performance, L3 provides less IPs usage. It is taking effect only if instance_id + ip_address is provided, not subnet_id + ip_address, because we're considering this as intentional subnet_id specification. Available values: "L2", "L3".
    projectId number
    Project ID
    regionId number
    Region ID
    tags {[key: string]: string}
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    vipIpFamily string
    IP family for load balancer subnet auto-selection if vip_network_id is specified Available values: "dual", "ipv4", "ipv6".
    vipNetworkId string
    Network ID for load balancer. If not specified, default external network will be used. Mutually exclusive with vip_port_id
    vipPortId string
    Existing Reserved Fixed IP port ID for load balancer. Mutually exclusive with vip_network_id
    vipSubnetId string
    Subnet ID for load balancer. If not specified, any subnet from vip_network_id will be selected. Ignored when vip_network_id is not specified.
    flavor str
    Load balancer flavor name
    floating_ip CloudLoadBalancerFloatingIpArgs
    Floating IP configuration for assignment
    logging CloudLoadBalancerLoggingArgs
    Logging configuration
    name str
    Load balancer name. Either name or name_template should be specified.
    name_template str
    Load balancer name which will be changed by template. Either name or name_template should be specified.
    preferred_connectivity str
    Preferred option to establish connectivity between load balancer and its pools members. L2 provides best performance, L3 provides less IPs usage. It is taking effect only if instance_id + ip_address is provided, not subnet_id + ip_address, because we're considering this as intentional subnet_id specification. Available values: "L2", "L3".
    project_id float
    Project ID
    region_id float
    Region ID
    tags Mapping[str, str]
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    vip_ip_family str
    IP family for load balancer subnet auto-selection if vip_network_id is specified Available values: "dual", "ipv4", "ipv6".
    vip_network_id str
    Network ID for load balancer. If not specified, default external network will be used. Mutually exclusive with vip_port_id
    vip_port_id str
    Existing Reserved Fixed IP port ID for load balancer. Mutually exclusive with vip_network_id
    vip_subnet_id str
    Subnet ID for load balancer. If not specified, any subnet from vip_network_id will be selected. Ignored when vip_network_id is not specified.
    flavor String
    Load balancer flavor name
    floatingIp Property Map
    Floating IP configuration for assignment
    logging Property Map
    Logging configuration
    name String
    Load balancer name. Either name or name_template should be specified.
    nameTemplate String
    Load balancer name which will be changed by template. Either name or name_template should be specified.
    preferredConnectivity String
    Preferred option to establish connectivity between load balancer and its pools members. L2 provides best performance, L3 provides less IPs usage. It is taking effect only if instance_id + ip_address is provided, not subnet_id + ip_address, because we're considering this as intentional subnet_id specification. Available values: "L2", "L3".
    projectId Number
    Project ID
    regionId Number
    Region ID
    tags Map<String>
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    vipIpFamily String
    IP family for load balancer subnet auto-selection if vip_network_id is specified Available values: "dual", "ipv4", "ipv6".
    vipNetworkId String
    Network ID for load balancer. If not specified, default external network will be used. Mutually exclusive with vip_port_id
    vipPortId String
    Existing Reserved Fixed IP port ID for load balancer. Mutually exclusive with vip_network_id
    vipSubnetId String
    Subnet ID for load balancer. If not specified, any subnet from vip_network_id will be selected. Ignored when vip_network_id is not specified.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the CloudLoadBalancer resource produces the following output properties:

    AdditionalVips List<CloudLoadBalancerAdditionalVip>
    List of additional IP addresses
    AdminStateUp bool
    Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
    CreatedAt string
    Datetime when the load balancer was created
    CreatorTaskId string
    Task that created this entity
    FloatingIps List<CloudLoadBalancerFloatingIp>
    List of assigned floating IPs
    Id string
    The provider-assigned unique ID for this managed resource.
    OperatingStatus string
    Load balancer operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
    ProvisioningStatus string
    Load balancer lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
    Region string
    Region name
    Stats CloudLoadBalancerStats
    Statistics of load balancer.
    TagsV2s List<CloudLoadBalancerTagsV2>
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    UpdatedAt string
    Datetime when the load balancer was last updated
    VipAddress string
    Load balancer IP address
    VipFqdn string
    Fully qualified domain name for the load balancer VIP
    VrrpIps List<CloudLoadBalancerVrrpIp>
    List of VRRP IP addresses
    AdditionalVips []CloudLoadBalancerAdditionalVip
    List of additional IP addresses
    AdminStateUp bool
    Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
    CreatedAt string
    Datetime when the load balancer was created
    CreatorTaskId string
    Task that created this entity
    FloatingIps []CloudLoadBalancerFloatingIp
    List of assigned floating IPs
    Id string
    The provider-assigned unique ID for this managed resource.
    OperatingStatus string
    Load balancer operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
    ProvisioningStatus string
    Load balancer lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
    Region string
    Region name
    Stats CloudLoadBalancerStats
    Statistics of load balancer.
    TagsV2s []CloudLoadBalancerTagsV2
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    UpdatedAt string
    Datetime when the load balancer was last updated
    VipAddress string
    Load balancer IP address
    VipFqdn string
    Fully qualified domain name for the load balancer VIP
    VrrpIps []CloudLoadBalancerVrrpIp
    List of VRRP IP addresses
    additionalVips List<CloudLoadBalancerAdditionalVip>
    List of additional IP addresses
    adminStateUp Boolean
    Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
    createdAt String
    Datetime when the load balancer was created
    creatorTaskId String
    Task that created this entity
    floatingIps List<CloudLoadBalancerFloatingIp>
    List of assigned floating IPs
    id String
    The provider-assigned unique ID for this managed resource.
    operatingStatus String
    Load balancer operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
    provisioningStatus String
    Load balancer lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
    region String
    Region name
    stats CloudLoadBalancerStats
    Statistics of load balancer.
    tagsV2s List<CloudLoadBalancerTagsV2>
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updatedAt String
    Datetime when the load balancer was last updated
    vipAddress String
    Load balancer IP address
    vipFqdn String
    Fully qualified domain name for the load balancer VIP
    vrrpIps List<CloudLoadBalancerVrrpIp>
    List of VRRP IP addresses
    additionalVips CloudLoadBalancerAdditionalVip[]
    List of additional IP addresses
    adminStateUp boolean
    Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
    createdAt string
    Datetime when the load balancer was created
    creatorTaskId string
    Task that created this entity
    floatingIps CloudLoadBalancerFloatingIp[]
    List of assigned floating IPs
    id string
    The provider-assigned unique ID for this managed resource.
    operatingStatus string
    Load balancer operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
    provisioningStatus string
    Load balancer lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
    region string
    Region name
    stats CloudLoadBalancerStats
    Statistics of load balancer.
    tagsV2s CloudLoadBalancerTagsV2[]
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updatedAt string
    Datetime when the load balancer was last updated
    vipAddress string
    Load balancer IP address
    vipFqdn string
    Fully qualified domain name for the load balancer VIP
    vrrpIps CloudLoadBalancerVrrpIp[]
    List of VRRP IP addresses
    additional_vips Sequence[CloudLoadBalancerAdditionalVip]
    List of additional IP addresses
    admin_state_up bool
    Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
    created_at str
    Datetime when the load balancer was created
    creator_task_id str
    Task that created this entity
    floating_ips Sequence[CloudLoadBalancerFloatingIp]
    List of assigned floating IPs
    id str
    The provider-assigned unique ID for this managed resource.
    operating_status str
    Load balancer operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
    provisioning_status str
    Load balancer lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
    region str
    Region name
    stats CloudLoadBalancerStats
    Statistics of load balancer.
    tags_v2s Sequence[CloudLoadBalancerTagsV2]
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updated_at str
    Datetime when the load balancer was last updated
    vip_address str
    Load balancer IP address
    vip_fqdn str
    Fully qualified domain name for the load balancer VIP
    vrrp_ips Sequence[CloudLoadBalancerVrrpIp]
    List of VRRP IP addresses
    additionalVips List<Property Map>
    List of additional IP addresses
    adminStateUp Boolean
    Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
    createdAt String
    Datetime when the load balancer was created
    creatorTaskId String
    Task that created this entity
    floatingIps List<Property Map>
    List of assigned floating IPs
    id String
    The provider-assigned unique ID for this managed resource.
    operatingStatus String
    Load balancer operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
    provisioningStatus String
    Load balancer lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
    region String
    Region name
    stats Property Map
    Statistics of load balancer.
    tagsV2s List<Property Map>
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updatedAt String
    Datetime when the load balancer was last updated
    vipAddress String
    Load balancer IP address
    vipFqdn String
    Fully qualified domain name for the load balancer VIP
    vrrpIps List<Property Map>
    List of VRRP IP addresses

    Look up Existing CloudLoadBalancer Resource

    Get an existing CloudLoadBalancer resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: CloudLoadBalancerState, opts?: CustomResourceOptions): CloudLoadBalancer
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            additional_vips: Optional[Sequence[CloudLoadBalancerAdditionalVipArgs]] = None,
            admin_state_up: Optional[bool] = None,
            created_at: Optional[str] = None,
            creator_task_id: Optional[str] = None,
            flavor: Optional[str] = None,
            floating_ip: Optional[CloudLoadBalancerFloatingIpArgs] = None,
            floating_ips: Optional[Sequence[CloudLoadBalancerFloatingIpArgs]] = None,
            logging: Optional[CloudLoadBalancerLoggingArgs] = None,
            name: Optional[str] = None,
            name_template: Optional[str] = None,
            operating_status: Optional[str] = None,
            preferred_connectivity: Optional[str] = None,
            project_id: Optional[float] = None,
            provisioning_status: Optional[str] = None,
            region: Optional[str] = None,
            region_id: Optional[float] = None,
            stats: Optional[CloudLoadBalancerStatsArgs] = None,
            tags: Optional[Mapping[str, str]] = None,
            tags_v2s: Optional[Sequence[CloudLoadBalancerTagsV2Args]] = None,
            updated_at: Optional[str] = None,
            vip_address: Optional[str] = None,
            vip_fqdn: Optional[str] = None,
            vip_ip_family: Optional[str] = None,
            vip_network_id: Optional[str] = None,
            vip_port_id: Optional[str] = None,
            vip_subnet_id: Optional[str] = None,
            vrrp_ips: Optional[Sequence[CloudLoadBalancerVrrpIpArgs]] = None) -> CloudLoadBalancer
    func GetCloudLoadBalancer(ctx *Context, name string, id IDInput, state *CloudLoadBalancerState, opts ...ResourceOption) (*CloudLoadBalancer, error)
    public static CloudLoadBalancer Get(string name, Input<string> id, CloudLoadBalancerState? state, CustomResourceOptions? opts = null)
    public static CloudLoadBalancer get(String name, Output<String> id, CloudLoadBalancerState state, CustomResourceOptions options)
    resources:  _:    type: gcore:CloudLoadBalancer    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AdditionalVips List<CloudLoadBalancerAdditionalVip>
    List of additional IP addresses
    AdminStateUp bool
    Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
    CreatedAt string
    Datetime when the load balancer was created
    CreatorTaskId string
    Task that created this entity
    Flavor string
    Load balancer flavor name
    FloatingIp CloudLoadBalancerFloatingIp
    Floating IP configuration for assignment
    FloatingIps List<CloudLoadBalancerFloatingIp>
    List of assigned floating IPs
    Logging CloudLoadBalancerLogging
    Logging configuration
    Name string
    Load balancer name. Either name or name_template should be specified.
    NameTemplate string
    Load balancer name which will be changed by template. Either name or name_template should be specified.
    OperatingStatus string
    Load balancer operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
    PreferredConnectivity string
    Preferred option to establish connectivity between load balancer and its pools members. L2 provides best performance, L3 provides less IPs usage. It is taking effect only if instance_id + ip_address is provided, not subnet_id + ip_address, because we're considering this as intentional subnet_id specification. Available values: "L2", "L3".
    ProjectId double
    Project ID
    ProvisioningStatus string
    Load balancer lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
    Region string
    Region name
    RegionId double
    Region ID
    Stats CloudLoadBalancerStats
    Statistics of load balancer.
    Tags Dictionary<string, string>
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    TagsV2s List<CloudLoadBalancerTagsV2>
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    UpdatedAt string
    Datetime when the load balancer was last updated
    VipAddress string
    Load balancer IP address
    VipFqdn string
    Fully qualified domain name for the load balancer VIP
    VipIpFamily string
    IP family for load balancer subnet auto-selection if vip_network_id is specified Available values: "dual", "ipv4", "ipv6".
    VipNetworkId string
    Network ID for load balancer. If not specified, default external network will be used. Mutually exclusive with vip_port_id
    VipPortId string
    Existing Reserved Fixed IP port ID for load balancer. Mutually exclusive with vip_network_id
    VipSubnetId string
    Subnet ID for load balancer. If not specified, any subnet from vip_network_id will be selected. Ignored when vip_network_id is not specified.
    VrrpIps List<CloudLoadBalancerVrrpIp>
    List of VRRP IP addresses
    AdditionalVips []CloudLoadBalancerAdditionalVipArgs
    List of additional IP addresses
    AdminStateUp bool
    Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
    CreatedAt string
    Datetime when the load balancer was created
    CreatorTaskId string
    Task that created this entity
    Flavor string
    Load balancer flavor name
    FloatingIp CloudLoadBalancerFloatingIpArgs
    Floating IP configuration for assignment
    FloatingIps []CloudLoadBalancerFloatingIpArgs
    List of assigned floating IPs
    Logging CloudLoadBalancerLoggingArgs
    Logging configuration
    Name string
    Load balancer name. Either name or name_template should be specified.
    NameTemplate string
    Load balancer name which will be changed by template. Either name or name_template should be specified.
    OperatingStatus string
    Load balancer operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
    PreferredConnectivity string
    Preferred option to establish connectivity between load balancer and its pools members. L2 provides best performance, L3 provides less IPs usage. It is taking effect only if instance_id + ip_address is provided, not subnet_id + ip_address, because we're considering this as intentional subnet_id specification. Available values: "L2", "L3".
    ProjectId float64
    Project ID
    ProvisioningStatus string
    Load balancer lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
    Region string
    Region name
    RegionId float64
    Region ID
    Stats CloudLoadBalancerStatsArgs
    Statistics of load balancer.
    Tags map[string]string
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    TagsV2s []CloudLoadBalancerTagsV2Args
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    UpdatedAt string
    Datetime when the load balancer was last updated
    VipAddress string
    Load balancer IP address
    VipFqdn string
    Fully qualified domain name for the load balancer VIP
    VipIpFamily string
    IP family for load balancer subnet auto-selection if vip_network_id is specified Available values: "dual", "ipv4", "ipv6".
    VipNetworkId string
    Network ID for load balancer. If not specified, default external network will be used. Mutually exclusive with vip_port_id
    VipPortId string
    Existing Reserved Fixed IP port ID for load balancer. Mutually exclusive with vip_network_id
    VipSubnetId string
    Subnet ID for load balancer. If not specified, any subnet from vip_network_id will be selected. Ignored when vip_network_id is not specified.
    VrrpIps []CloudLoadBalancerVrrpIpArgs
    List of VRRP IP addresses
    additionalVips List<CloudLoadBalancerAdditionalVip>
    List of additional IP addresses
    adminStateUp Boolean
    Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
    createdAt String
    Datetime when the load balancer was created
    creatorTaskId String
    Task that created this entity
    flavor String
    Load balancer flavor name
    floatingIp CloudLoadBalancerFloatingIp
    Floating IP configuration for assignment
    floatingIps List<CloudLoadBalancerFloatingIp>
    List of assigned floating IPs
    logging CloudLoadBalancerLogging
    Logging configuration
    name String
    Load balancer name. Either name or name_template should be specified.
    nameTemplate String
    Load balancer name which will be changed by template. Either name or name_template should be specified.
    operatingStatus String
    Load balancer operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
    preferredConnectivity String
    Preferred option to establish connectivity between load balancer and its pools members. L2 provides best performance, L3 provides less IPs usage. It is taking effect only if instance_id + ip_address is provided, not subnet_id + ip_address, because we're considering this as intentional subnet_id specification. Available values: "L2", "L3".
    projectId Double
    Project ID
    provisioningStatus String
    Load balancer lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
    region String
    Region name
    regionId Double
    Region ID
    stats CloudLoadBalancerStats
    Statistics of load balancer.
    tags Map<String,String>
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    tagsV2s List<CloudLoadBalancerTagsV2>
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updatedAt String
    Datetime when the load balancer was last updated
    vipAddress String
    Load balancer IP address
    vipFqdn String
    Fully qualified domain name for the load balancer VIP
    vipIpFamily String
    IP family for load balancer subnet auto-selection if vip_network_id is specified Available values: "dual", "ipv4", "ipv6".
    vipNetworkId String
    Network ID for load balancer. If not specified, default external network will be used. Mutually exclusive with vip_port_id
    vipPortId String
    Existing Reserved Fixed IP port ID for load balancer. Mutually exclusive with vip_network_id
    vipSubnetId String
    Subnet ID for load balancer. If not specified, any subnet from vip_network_id will be selected. Ignored when vip_network_id is not specified.
    vrrpIps List<CloudLoadBalancerVrrpIp>
    List of VRRP IP addresses
    additionalVips CloudLoadBalancerAdditionalVip[]
    List of additional IP addresses
    adminStateUp boolean
    Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
    createdAt string
    Datetime when the load balancer was created
    creatorTaskId string
    Task that created this entity
    flavor string
    Load balancer flavor name
    floatingIp CloudLoadBalancerFloatingIp
    Floating IP configuration for assignment
    floatingIps CloudLoadBalancerFloatingIp[]
    List of assigned floating IPs
    logging CloudLoadBalancerLogging
    Logging configuration
    name string
    Load balancer name. Either name or name_template should be specified.
    nameTemplate string
    Load balancer name which will be changed by template. Either name or name_template should be specified.
    operatingStatus string
    Load balancer operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
    preferredConnectivity string
    Preferred option to establish connectivity between load balancer and its pools members. L2 provides best performance, L3 provides less IPs usage. It is taking effect only if instance_id + ip_address is provided, not subnet_id + ip_address, because we're considering this as intentional subnet_id specification. Available values: "L2", "L3".
    projectId number
    Project ID
    provisioningStatus string
    Load balancer lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
    region string
    Region name
    regionId number
    Region ID
    stats CloudLoadBalancerStats
    Statistics of load balancer.
    tags {[key: string]: string}
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    tagsV2s CloudLoadBalancerTagsV2[]
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updatedAt string
    Datetime when the load balancer was last updated
    vipAddress string
    Load balancer IP address
    vipFqdn string
    Fully qualified domain name for the load balancer VIP
    vipIpFamily string
    IP family for load balancer subnet auto-selection if vip_network_id is specified Available values: "dual", "ipv4", "ipv6".
    vipNetworkId string
    Network ID for load balancer. If not specified, default external network will be used. Mutually exclusive with vip_port_id
    vipPortId string
    Existing Reserved Fixed IP port ID for load balancer. Mutually exclusive with vip_network_id
    vipSubnetId string
    Subnet ID for load balancer. If not specified, any subnet from vip_network_id will be selected. Ignored when vip_network_id is not specified.
    vrrpIps CloudLoadBalancerVrrpIp[]
    List of VRRP IP addresses
    additional_vips Sequence[CloudLoadBalancerAdditionalVipArgs]
    List of additional IP addresses
    admin_state_up bool
    Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
    created_at str
    Datetime when the load balancer was created
    creator_task_id str
    Task that created this entity
    flavor str
    Load balancer flavor name
    floating_ip CloudLoadBalancerFloatingIpArgs
    Floating IP configuration for assignment
    floating_ips Sequence[CloudLoadBalancerFloatingIpArgs]
    List of assigned floating IPs
    logging CloudLoadBalancerLoggingArgs
    Logging configuration
    name str
    Load balancer name. Either name or name_template should be specified.
    name_template str
    Load balancer name which will be changed by template. Either name or name_template should be specified.
    operating_status str
    Load balancer operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
    preferred_connectivity str
    Preferred option to establish connectivity between load balancer and its pools members. L2 provides best performance, L3 provides less IPs usage. It is taking effect only if instance_id + ip_address is provided, not subnet_id + ip_address, because we're considering this as intentional subnet_id specification. Available values: "L2", "L3".
    project_id float
    Project ID
    provisioning_status str
    Load balancer lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
    region str
    Region name
    region_id float
    Region ID
    stats CloudLoadBalancerStatsArgs
    Statistics of load balancer.
    tags Mapping[str, str]
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    tags_v2s Sequence[CloudLoadBalancerTagsV2Args]
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updated_at str
    Datetime when the load balancer was last updated
    vip_address str
    Load balancer IP address
    vip_fqdn str
    Fully qualified domain name for the load balancer VIP
    vip_ip_family str
    IP family for load balancer subnet auto-selection if vip_network_id is specified Available values: "dual", "ipv4", "ipv6".
    vip_network_id str
    Network ID for load balancer. If not specified, default external network will be used. Mutually exclusive with vip_port_id
    vip_port_id str
    Existing Reserved Fixed IP port ID for load balancer. Mutually exclusive with vip_network_id
    vip_subnet_id str
    Subnet ID for load balancer. If not specified, any subnet from vip_network_id will be selected. Ignored when vip_network_id is not specified.
    vrrp_ips Sequence[CloudLoadBalancerVrrpIpArgs]
    List of VRRP IP addresses
    additionalVips List<Property Map>
    List of additional IP addresses
    adminStateUp Boolean
    Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
    createdAt String
    Datetime when the load balancer was created
    creatorTaskId String
    Task that created this entity
    flavor String
    Load balancer flavor name
    floatingIp Property Map
    Floating IP configuration for assignment
    floatingIps List<Property Map>
    List of assigned floating IPs
    logging Property Map
    Logging configuration
    name String
    Load balancer name. Either name or name_template should be specified.
    nameTemplate String
    Load balancer name which will be changed by template. Either name or name_template should be specified.
    operatingStatus String
    Load balancer operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
    preferredConnectivity String
    Preferred option to establish connectivity between load balancer and its pools members. L2 provides best performance, L3 provides less IPs usage. It is taking effect only if instance_id + ip_address is provided, not subnet_id + ip_address, because we're considering this as intentional subnet_id specification. Available values: "L2", "L3".
    projectId Number
    Project ID
    provisioningStatus String
    Load balancer lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
    region String
    Region name
    regionId Number
    Region ID
    stats Property Map
    Statistics of load balancer.
    tags Map<String>
    Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    tagsV2s List<Property Map>
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updatedAt String
    Datetime when the load balancer was last updated
    vipAddress String
    Load balancer IP address
    vipFqdn String
    Fully qualified domain name for the load balancer VIP
    vipIpFamily String
    IP family for load balancer subnet auto-selection if vip_network_id is specified Available values: "dual", "ipv4", "ipv6".
    vipNetworkId String
    Network ID for load balancer. If not specified, default external network will be used. Mutually exclusive with vip_port_id
    vipPortId String
    Existing Reserved Fixed IP port ID for load balancer. Mutually exclusive with vip_network_id
    vipSubnetId String
    Subnet ID for load balancer. If not specified, any subnet from vip_network_id will be selected. Ignored when vip_network_id is not specified.
    vrrpIps List<Property Map>
    List of VRRP IP addresses

    Supporting Types

    CloudLoadBalancerAdditionalVip, CloudLoadBalancerAdditionalVipArgs

    IpAddress string
    IP address
    SubnetId string
    Subnet UUID
    IpAddress string
    IP address
    SubnetId string
    Subnet UUID
    ipAddress String
    IP address
    subnetId String
    Subnet UUID
    ipAddress string
    IP address
    subnetId string
    Subnet UUID
    ip_address str
    IP address
    subnet_id str
    Subnet UUID
    ipAddress String
    IP address
    subnetId String
    Subnet UUID

    CloudLoadBalancerFloatingIp, CloudLoadBalancerFloatingIpArgs

    CreatedAt string
    Datetime when the floating IP was created
    CreatorTaskId string
    Task that created this entity
    FixedIpAddress string
    IP address of the port the floating IP is attached to
    FloatingIpAddress string
    IP Address of the floating IP
    Id string
    Floating IP ID
    PortId string
    Port ID the floating IP is attached to. The fixed_ip_address is the IP address of the port.
    ProjectId double
    Project ID
    Region string
    Region name
    RegionId double
    Region ID
    RouterId string
    Router ID
    Status string
    Floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
    Tags List<CloudLoadBalancerFloatingIpTag>
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    UpdatedAt string
    Datetime when the floating IP was last updated
    CreatedAt string
    Datetime when the floating IP was created
    CreatorTaskId string
    Task that created this entity
    FixedIpAddress string
    IP address of the port the floating IP is attached to
    FloatingIpAddress string
    IP Address of the floating IP
    Id string
    Floating IP ID
    PortId string
    Port ID the floating IP is attached to. The fixed_ip_address is the IP address of the port.
    ProjectId float64
    Project ID
    Region string
    Region name
    RegionId float64
    Region ID
    RouterId string
    Router ID
    Status string
    Floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
    Tags []CloudLoadBalancerFloatingIpTag
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    UpdatedAt string
    Datetime when the floating IP was last updated
    createdAt String
    Datetime when the floating IP was created
    creatorTaskId String
    Task that created this entity
    fixedIpAddress String
    IP address of the port the floating IP is attached to
    floatingIpAddress String
    IP Address of the floating IP
    id String
    Floating IP ID
    portId String
    Port ID the floating IP is attached to. The fixed_ip_address is the IP address of the port.
    projectId Double
    Project ID
    region String
    Region name
    regionId Double
    Region ID
    routerId String
    Router ID
    status String
    Floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
    tags List<CloudLoadBalancerFloatingIpTag>
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updatedAt String
    Datetime when the floating IP was last updated
    createdAt string
    Datetime when the floating IP was created
    creatorTaskId string
    Task that created this entity
    fixedIpAddress string
    IP address of the port the floating IP is attached to
    floatingIpAddress string
    IP Address of the floating IP
    id string
    Floating IP ID
    portId string
    Port ID the floating IP is attached to. The fixed_ip_address is the IP address of the port.
    projectId number
    Project ID
    region string
    Region name
    regionId number
    Region ID
    routerId string
    Router ID
    status string
    Floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
    tags CloudLoadBalancerFloatingIpTag[]
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updatedAt string
    Datetime when the floating IP was last updated
    created_at str
    Datetime when the floating IP was created
    creator_task_id str
    Task that created this entity
    fixed_ip_address str
    IP address of the port the floating IP is attached to
    floating_ip_address str
    IP Address of the floating IP
    id str
    Floating IP ID
    port_id str
    Port ID the floating IP is attached to. The fixed_ip_address is the IP address of the port.
    project_id float
    Project ID
    region str
    Region name
    region_id float
    Region ID
    router_id str
    Router ID
    status str
    Floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
    tags Sequence[CloudLoadBalancerFloatingIpTag]
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updated_at str
    Datetime when the floating IP was last updated
    createdAt String
    Datetime when the floating IP was created
    creatorTaskId String
    Task that created this entity
    fixedIpAddress String
    IP address of the port the floating IP is attached to
    floatingIpAddress String
    IP Address of the floating IP
    id String
    Floating IP ID
    portId String
    Port ID the floating IP is attached to. The fixed_ip_address is the IP address of the port.
    projectId Number
    Project ID
    region String
    Region name
    regionId Number
    Region ID
    routerId String
    Router ID
    status String
    Floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
    tags List<Property Map>
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    updatedAt String
    Datetime when the floating IP was last updated

    CloudLoadBalancerFloatingIpTag, CloudLoadBalancerFloatingIpTagArgs

    Key string
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    ReadOnly bool
    If true, the tag is read-only and cannot be modified by the user
    Value string
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    Key string
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    ReadOnly bool
    If true, the tag is read-only and cannot be modified by the user
    Value string
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    key String
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    readOnly Boolean
    If true, the tag is read-only and cannot be modified by the user
    value String
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    key string
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    readOnly boolean
    If true, the tag is read-only and cannot be modified by the user
    value string
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    key str
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    read_only bool
    If true, the tag is read-only and cannot be modified by the user
    value str
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    key String
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    readOnly Boolean
    If true, the tag is read-only and cannot be modified by the user
    value String
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.

    CloudLoadBalancerLogging, CloudLoadBalancerLoggingArgs

    DestinationRegionId double
    Destination region id to which the logs will be written
    Enabled bool
    Enable/disable forwarding logs to LaaS
    RetentionPolicy CloudLoadBalancerLoggingRetentionPolicy
    The logs retention policy
    TopicName string
    The topic name to which the logs will be written
    DestinationRegionId float64
    Destination region id to which the logs will be written
    Enabled bool
    Enable/disable forwarding logs to LaaS
    RetentionPolicy CloudLoadBalancerLoggingRetentionPolicy
    The logs retention policy
    TopicName string
    The topic name to which the logs will be written
    destinationRegionId Double
    Destination region id to which the logs will be written
    enabled Boolean
    Enable/disable forwarding logs to LaaS
    retentionPolicy CloudLoadBalancerLoggingRetentionPolicy
    The logs retention policy
    topicName String
    The topic name to which the logs will be written
    destinationRegionId number
    Destination region id to which the logs will be written
    enabled boolean
    Enable/disable forwarding logs to LaaS
    retentionPolicy CloudLoadBalancerLoggingRetentionPolicy
    The logs retention policy
    topicName string
    The topic name to which the logs will be written
    destination_region_id float
    Destination region id to which the logs will be written
    enabled bool
    Enable/disable forwarding logs to LaaS
    retention_policy CloudLoadBalancerLoggingRetentionPolicy
    The logs retention policy
    topic_name str
    The topic name to which the logs will be written
    destinationRegionId Number
    Destination region id to which the logs will be written
    enabled Boolean
    Enable/disable forwarding logs to LaaS
    retentionPolicy Property Map
    The logs retention policy
    topicName String
    The topic name to which the logs will be written

    CloudLoadBalancerLoggingRetentionPolicy, CloudLoadBalancerLoggingRetentionPolicyArgs

    Period double
    Duration of days for which logs must be kept.
    Period float64
    Duration of days for which logs must be kept.
    period Double
    Duration of days for which logs must be kept.
    period number
    Duration of days for which logs must be kept.
    period float
    Duration of days for which logs must be kept.
    period Number
    Duration of days for which logs must be kept.

    CloudLoadBalancerStats, CloudLoadBalancerStatsArgs

    ActiveConnections double
    Currently active connections
    BytesIn double
    Total bytes received
    BytesOut double
    Total bytes sent
    RequestErrors double
    Total requests that were unable to be fulfilled
    TotalConnections double
    Total connections handled
    ActiveConnections float64
    Currently active connections
    BytesIn float64
    Total bytes received
    BytesOut float64
    Total bytes sent
    RequestErrors float64
    Total requests that were unable to be fulfilled
    TotalConnections float64
    Total connections handled
    activeConnections Double
    Currently active connections
    bytesIn Double
    Total bytes received
    bytesOut Double
    Total bytes sent
    requestErrors Double
    Total requests that were unable to be fulfilled
    totalConnections Double
    Total connections handled
    activeConnections number
    Currently active connections
    bytesIn number
    Total bytes received
    bytesOut number
    Total bytes sent
    requestErrors number
    Total requests that were unable to be fulfilled
    totalConnections number
    Total connections handled
    active_connections float
    Currently active connections
    bytes_in float
    Total bytes received
    bytes_out float
    Total bytes sent
    request_errors float
    Total requests that were unable to be fulfilled
    total_connections float
    Total connections handled
    activeConnections Number
    Currently active connections
    bytesIn Number
    Total bytes received
    bytesOut Number
    Total bytes sent
    requestErrors Number
    Total requests that were unable to be fulfilled
    totalConnections Number
    Total connections handled

    CloudLoadBalancerTagsV2, CloudLoadBalancerTagsV2Args

    Key string
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    ReadOnly bool
    If true, the tag is read-only and cannot be modified by the user
    Value string
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    Key string
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    ReadOnly bool
    If true, the tag is read-only and cannot be modified by the user
    Value string
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    key String
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    readOnly Boolean
    If true, the tag is read-only and cannot be modified by the user
    value String
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    key string
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    readOnly boolean
    If true, the tag is read-only and cannot be modified by the user
    value string
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    key str
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    read_only bool
    If true, the tag is read-only and cannot be modified by the user
    value str
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    key String
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    readOnly Boolean
    If true, the tag is read-only and cannot be modified by the user
    value String
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.

    CloudLoadBalancerVrrpIp, CloudLoadBalancerVrrpIpArgs

    IpAddress string
    IP address
    Role string
    LoadBalancer instance role to which VRRP IP belong Available values: "BACKUP", "MASTER", "STANDALONE".
    SubnetId string
    Subnet UUID
    IpAddress string
    IP address
    Role string
    LoadBalancer instance role to which VRRP IP belong Available values: "BACKUP", "MASTER", "STANDALONE".
    SubnetId string
    Subnet UUID
    ipAddress String
    IP address
    role String
    LoadBalancer instance role to which VRRP IP belong Available values: "BACKUP", "MASTER", "STANDALONE".
    subnetId String
    Subnet UUID
    ipAddress string
    IP address
    role string
    LoadBalancer instance role to which VRRP IP belong Available values: "BACKUP", "MASTER", "STANDALONE".
    subnetId string
    Subnet UUID
    ip_address str
    IP address
    role str
    LoadBalancer instance role to which VRRP IP belong Available values: "BACKUP", "MASTER", "STANDALONE".
    subnet_id str
    Subnet UUID
    ipAddress String
    IP address
    role String
    LoadBalancer instance role to which VRRP IP belong Available values: "BACKUP", "MASTER", "STANDALONE".
    subnetId String
    Subnet UUID

    Import

    $ pulumi import gcore:index/cloudLoadBalancer:CloudLoadBalancer example '<project_id>/<region_id>/<load_balancer_id>'
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    gcore g-core/terraform-provider-gcore
    License
    Notes
    This Pulumi package is based on the gcore Terraform Provider.
    Viewing docs for gcore 2.0.0-alpha.3
    published on Monday, Mar 30, 2026 by g-core
      Try Pulumi Cloud free. Your team will thank you.