pulumi-alicloud-kotlin/com.pulumi.alicloud.alb.kotlin/LoadBalancer

LoadBalancer

class LoadBalancer : KotlinCustomResource

Provides a Application Load Balancer (ALB) Load Balancer resource. Load Balancer Instance. For information about Application Load Balancer (ALB) Load Balancer and how to use it, see What is Load Balancer.

NOTE: Available since v1.132.0.

Example Usage

Basic Usage

import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const config = new pulumi.Config();
const name = config.get("name") || "terraform-example";
const _default = alicloud.resourcemanager.getResourceGroups({});
const defaultGetZones = alicloud.alb.getZones({});
const defaultNetwork = new alicloud.vpc.Network("default", {
    vpcName: name,
    cidrBlock: "10.4.0.0/16",
});
const default1 = new alicloud.vpc.Switch("default1", {
    vpcId: defaultNetwork.id,
    cidrBlock: "10.4.1.0/24",
    zoneId: defaultGetZones.then(defaultGetZones => defaultGetZones.zones?.[0]?.id),
    vswitchName: `${name}_1`,
});
const default2 = new alicloud.vpc.Switch("default2", {
    vpcId: defaultNetwork.id,
    cidrBlock: "10.4.2.0/24",
    zoneId: defaultGetZones.then(defaultGetZones => defaultGetZones.zones?.[1]?.id),
    vswitchName: `${name}_2`,
});
const defaultLoadBalancer = new alicloud.alb.LoadBalancer("default", {
    loadBalancerEdition: "Basic",
    addressType: "Internet",
    vpcId: defaultNetwork.id,
    addressAllocatedMode: "Fixed",
    resourceGroupId: _default.then(_default => _default.groups?.[0]?.id),
    loadBalancerName: name,
    loadBalancerBillingConfig: {
        payType: "PayAsYouGo",
    },
    modificationProtectionConfig: {
        status: "NonProtection",
    },
    zoneMappings: [
        {
            vswitchId: default1.id,
            zoneId: defaultGetZones.then(defaultGetZones => defaultGetZones.zones?.[0]?.id),
        },
        {
            vswitchId: default2.id,
            zoneId: defaultGetZones.then(defaultGetZones => defaultGetZones.zones?.[1]?.id),
        },
    ],
    tags: {
        Created: "TF",
    },
});
Content copied to clipboard
import pulumi
import pulumi_alicloud as alicloud
config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "terraform-example"
default = alicloud.resourcemanager.get_resource_groups()
default_get_zones = alicloud.alb.get_zones()
default_network = alicloud.vpc.Network("default",
    vpc_name=name,
    cidr_block="10.4.0.0/16")
default1 = alicloud.vpc.Switch("default1",
    vpc_id=default_network.id,
    cidr_block="10.4.1.0/24",
    zone_id=default_get_zones.zones[0].id,
    vswitch_name=f"{name}_1")
default2 = alicloud.vpc.Switch("default2",
    vpc_id=default_network.id,
    cidr_block="10.4.2.0/24",
    zone_id=default_get_zones.zones[1].id,
    vswitch_name=f"{name}_2")
default_load_balancer = alicloud.alb.LoadBalancer("default",
    load_balancer_edition="Basic",
    address_type="Internet",
    vpc_id=default_network.id,
    address_allocated_mode="Fixed",
    resource_group_id=default.groups[0].id,
    load_balancer_name=name,
    load_balancer_billing_config={
        "pay_type": "PayAsYouGo",
    },
    modification_protection_config={
        "status": "NonProtection",
    },
    zone_mappings=[
        {
            "vswitch_id": default1.id,
            "zone_id": default_get_zones.zones[0].id,
        },
        {
            "vswitch_id": default2.id,
            "zone_id": default_get_zones.zones[1].id,
        },
    ],
    tags={
        "Created": "TF",
    })
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
    var config = new Config();
    var name = config.Get("name") ?? "terraform-example";
    var @default = AliCloud.ResourceManager.GetResourceGroups.Invoke();
    var defaultGetZones = AliCloud.Alb.GetZones.Invoke();
    var defaultNetwork = new AliCloud.Vpc.Network("default", new()
    {
        VpcName = name,
        CidrBlock = "10.4.0.0/16",
    });
    var default1 = new AliCloud.Vpc.Switch("default1", new()
    {
        VpcId = defaultNetwork.Id,
        CidrBlock = "10.4.1.0/24",
        ZoneId = defaultGetZones.Apply(getZonesResult => getZonesResult.Zones[0]?.Id),
        VswitchName = $"{name}_1",
    });
    var default2 = new AliCloud.Vpc.Switch("default2", new()
    {
        VpcId = defaultNetwork.Id,
        CidrBlock = "10.4.2.0/24",
        ZoneId = defaultGetZones.Apply(getZonesResult => getZonesResult.Zones[1]?.Id),
        VswitchName = $"{name}_2",
    });
    var defaultLoadBalancer = new AliCloud.Alb.LoadBalancer("default", new()
    {
        LoadBalancerEdition = "Basic",
        AddressType = "Internet",
        VpcId = defaultNetwork.Id,
        AddressAllocatedMode = "Fixed",
        ResourceGroupId = @default.Apply(@default => @default.Apply(getResourceGroupsResult => getResourceGroupsResult.Groups[0]?.Id)),
        LoadBalancerName = name,
        LoadBalancerBillingConfig = new AliCloud.Alb.Inputs.LoadBalancerLoadBalancerBillingConfigArgs
        {
            PayType = "PayAsYouGo",
        },
        ModificationProtectionConfig = new AliCloud.Alb.Inputs.LoadBalancerModificationProtectionConfigArgs
        {
            Status = "NonProtection",
        },
        ZoneMappings = new[]
        {
            new AliCloud.Alb.Inputs.LoadBalancerZoneMappingArgs
            {
                VswitchId = default1.Id,
                ZoneId = defaultGetZones.Apply(getZonesResult => getZonesResult.Zones[0]?.Id),
            },
            new AliCloud.Alb.Inputs.LoadBalancerZoneMappingArgs
            {
                VswitchId = default2.Id,
                ZoneId = defaultGetZones.Apply(getZonesResult => getZonesResult.Zones[1]?.Id),
            },
        },
        Tags =
        {
            { "Created", "TF" },
        },
    });
});
Content copied to clipboard
package main
import (
	"fmt"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/alb"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/resourcemanager"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/vpc"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		cfg := config.New(ctx, "")
		name := "terraform-example"
		if param := cfg.Get("name"); param != "" {
			name = param
		}
		_default, err := resourcemanager.GetResourceGroups(ctx, &resourcemanager.GetResourceGroupsArgs{}, nil)
		if err != nil {
			return err
		}
		defaultGetZones, err := alb.GetZones(ctx, &alb.GetZonesArgs{}, nil)
		if err != nil {
			return err
		}
		defaultNetwork, err := vpc.NewNetwork(ctx, "default", &vpc.NetworkArgs{
			VpcName:   pulumi.String(name),
			CidrBlock: pulumi.String("10.4.0.0/16"),
		})
		if err != nil {
			return err
		}
		default1, err := vpc.NewSwitch(ctx, "default1", &vpc.SwitchArgs{
			VpcId:       defaultNetwork.ID(),
			CidrBlock:   pulumi.String("10.4.1.0/24"),
			ZoneId:      pulumi.String(defaultGetZones.Zones[0].Id),
			VswitchName: pulumi.Sprintf("%v_1", name),
		})
		if err != nil {
			return err
		}
		default2, err := vpc.NewSwitch(ctx, "default2", &vpc.SwitchArgs{
			VpcId:       defaultNetwork.ID(),
			CidrBlock:   pulumi.String("10.4.2.0/24"),
			ZoneId:      pulumi.String(defaultGetZones.Zones[1].Id),
			VswitchName: pulumi.Sprintf("%v_2", name),
		})
		if err != nil {
			return err
		}
		_, err = alb.NewLoadBalancer(ctx, "default", &alb.LoadBalancerArgs{
			LoadBalancerEdition:  pulumi.String("Basic"),
			AddressType:          pulumi.String("Internet"),
			VpcId:                defaultNetwork.ID(),
			AddressAllocatedMode: pulumi.String("Fixed"),
			ResourceGroupId:      pulumi.String(_default.Groups[0].Id),
			LoadBalancerName:     pulumi.String(name),
			LoadBalancerBillingConfig: &alb.LoadBalancerLoadBalancerBillingConfigArgs{
				PayType: pulumi.String("PayAsYouGo"),
			},
			ModificationProtectionConfig: &alb.LoadBalancerModificationProtectionConfigArgs{
				Status: pulumi.String("NonProtection"),
			},
			ZoneMappings: alb.LoadBalancerZoneMappingArray{
				&alb.LoadBalancerZoneMappingArgs{
					VswitchId: default1.ID(),
					ZoneId:    pulumi.String(defaultGetZones.Zones[0].Id),
				},
				&alb.LoadBalancerZoneMappingArgs{
					VswitchId: default2.ID(),
					ZoneId:    pulumi.String(defaultGetZones.Zones[1].Id),
				},
			},
			Tags: pulumi.StringMap{
				"Created": pulumi.String("TF"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.resourcemanager.ResourcemanagerFunctions;
import com.pulumi.alicloud.resourcemanager.inputs.GetResourceGroupsArgs;
import com.pulumi.alicloud.alb.AlbFunctions;
import com.pulumi.alicloud.alb.inputs.GetZonesArgs;
import com.pulumi.alicloud.vpc.Network;
import com.pulumi.alicloud.vpc.NetworkArgs;
import com.pulumi.alicloud.vpc.Switch;
import com.pulumi.alicloud.vpc.SwitchArgs;
import com.pulumi.alicloud.alb.LoadBalancer;
import com.pulumi.alicloud.alb.LoadBalancerArgs;
import com.pulumi.alicloud.alb.inputs.LoadBalancerLoadBalancerBillingConfigArgs;
import com.pulumi.alicloud.alb.inputs.LoadBalancerModificationProtectionConfigArgs;
import com.pulumi.alicloud.alb.inputs.LoadBalancerZoneMappingArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var config = ctx.config();
        final var name = config.get("name").orElse("terraform-example");
        final var default = ResourcemanagerFunctions.getResourceGroups(GetResourceGroupsArgs.builder()
            .build());
        final var defaultGetZones = AlbFunctions.getZones(GetZonesArgs.builder()
            .build());
        var defaultNetwork = new Network("defaultNetwork", NetworkArgs.builder()
            .vpcName(name)
            .cidrBlock("10.4.0.0/16")
            .build());
        var default1 = new Switch("default1", SwitchArgs.builder()
            .vpcId(defaultNetwork.id())
            .cidrBlock("10.4.1.0/24")
            .zoneId(defaultGetZones.zones()[0].id())
            .vswitchName(String.format("%s_1", name))
            .build());
        var default2 = new Switch("default2", SwitchArgs.builder()
            .vpcId(defaultNetwork.id())
            .cidrBlock("10.4.2.0/24")
            .zoneId(defaultGetZones.zones()[1].id())
            .vswitchName(String.format("%s_2", name))
            .build());
        var defaultLoadBalancer = new LoadBalancer("defaultLoadBalancer", LoadBalancerArgs.builder()
            .loadBalancerEdition("Basic")
            .addressType("Internet")
            .vpcId(defaultNetwork.id())
            .addressAllocatedMode("Fixed")
            .resourceGroupId(default_.groups()[0].id())
            .loadBalancerName(name)
            .loadBalancerBillingConfig(LoadBalancerLoadBalancerBillingConfigArgs.builder()
                .payType("PayAsYouGo")
                .build())
            .modificationProtectionConfig(LoadBalancerModificationProtectionConfigArgs.builder()
                .status("NonProtection")
                .build())
            .zoneMappings(
                LoadBalancerZoneMappingArgs.builder()
                    .vswitchId(default1.id())
                    .zoneId(defaultGetZones.zones()[0].id())
                    .build(),
                LoadBalancerZoneMappingArgs.builder()
                    .vswitchId(default2.id())
                    .zoneId(defaultGetZones.zones()[1].id())
                    .build())
            .tags(Map.of("Created", "TF"))
            .build());
    }
}
Content copied to clipboard
configuration:
  name:
    type: string
    default: terraform-example
resources:
  defaultNetwork:
    type: alicloud:vpc:Network
    name: default
    properties:
      vpcName: ${name}
      cidrBlock: 10.4.0.0/16
  default1:
    type: alicloud:vpc:Switch
    properties:
      vpcId: ${defaultNetwork.id}
      cidrBlock: 10.4.1.0/24
      zoneId: ${defaultGetZones.zones[0].id}
      vswitchName: ${name}_1
  default2:
    type: alicloud:vpc:Switch
    properties:
      vpcId: ${defaultNetwork.id}
      cidrBlock: 10.4.2.0/24
      zoneId: ${defaultGetZones.zones[1].id}
      vswitchName: ${name}_2
  defaultLoadBalancer:
    type: alicloud:alb:LoadBalancer
    name: default
    properties:
      loadBalancerEdition: Basic
      addressType: Internet
      vpcId: ${defaultNetwork.id}
      addressAllocatedMode: Fixed
      resourceGroupId: ${default.groups[0].id}
      loadBalancerName: ${name}
      loadBalancerBillingConfig:
        payType: PayAsYouGo
      modificationProtectionConfig:
        status: NonProtection
      zoneMappings:
        - vswitchId: ${default1.id}
          zoneId: ${defaultGetZones.zones[0].id}
        - vswitchId: ${default2.id}
          zoneId: ${defaultGetZones.zones[1].id}
      tags:
        Created: TF
variables:
  default:
    fn::invoke:
      function: alicloud:resourcemanager:getResourceGroups
      arguments: {}
  defaultGetZones:
    fn::invoke:
      function: alicloud:alb:getZones
      arguments: {}
Content copied to clipboard

Import

Application Load Balancer (ALB) Load Balancer can be imported using the id, e.g.

$ pulumi import alicloud:alb/loadBalancer:LoadBalancer example <id>
Content copied to clipboard

Properties

Link copied to clipboard
val accessLogConfig: Output<LoadBalancerAccessLogConfig>?

The configuration of the access log. See access_log_config below.

Link copied to clipboard
val addressAllocatedMode: Output<String>?

The method in which IP addresses are assigned. Valid values: Fixed: The ALB instance uses a fixed IP address. Dynamic (default): An IP address is dynamically assigned to each zone of the ALB instance.

Link copied to clipboard
val addressIpVersion: Output<String>

The protocol version. Value:

Link copied to clipboard
val addressType: Output<String>

The type of IP address that the SLB instance uses to provide services.

Link copied to clipboard
val bandwidthPackageId: Output<String>?

The ID of the EIP bandwidth plan which is associated with an ALB instance that uses a public IP address.

Link copied to clipboard
val createTime: Output<String>

The creation time of the resource

Link copied to clipboard
val deletionProtectionConfig: Output<LoadBalancerDeletionProtectionConfig>

The Protection Configuration See deletion_protection_config below.

Link copied to clipboard
val deletionProtectionEnabled: Output<Boolean>

Specifies whether to enable deletion protection. Default value: false. Valid values:

Link copied to clipboard
val dnsName: Output<String>

DNS Domain Name

Link copied to clipboard
val dryRun: Output<Boolean>?

Whether to PreCheck only this request, value:

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val ipv6AddressType: Output<String>

The address type of Ipv6

Link copied to clipboard
val loadBalancerBillingConfig: Output<LoadBalancerLoadBalancerBillingConfig>

The configuration of the billing method. See load_balancer_billing_config below.

Link copied to clipboard
val loadBalancerEdition: Output<String>

The edition of the ALB instance.

Link copied to clipboard
val loadBalancerName: Output<String>?

The name of the resource

Link copied to clipboard
val modificationProtectionConfig: Output<LoadBalancerModificationProtectionConfig>

Modify the Protection Configuration See modification_protection_config below.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val regionId: Output<String>

The region ID of the resource

Link copied to clipboard
val resourceGroupId: Output<String>

The ID of the resource group

Link copied to clipboard
val status: Output<String>

Server Load Balancer Instance Status:, indicating that the instance listener will no longer forward traffic.(default).

Link copied to clipboard
val tags: Output<Map<String, String>>?

The tag of the resource

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard
val vpcId: Output<String>

The ID of the virtual private cloud (VPC) where the SLB instance is deployed.

Link copied to clipboard
val zoneMappings: Output<List<LoadBalancerZoneMapping>>

The zones and vSwitches. You must specify at least two zones. See zone_mappings below.