Sign in Dashboard Get started
  1. Packages
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. elasticloadbalancing
  6. LoadBalancer

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.69.0
published on Monday, Jun 15, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

aws-native.elasticloadbalancing.LoadBalancer

aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.69.0
published on Monday, Jun 15, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

    Resource Type definition for AWS::ElasticLoadBalancing::LoadBalancer

    Create LoadBalancer Resource

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

    Constructor syntax

    new LoadBalancer(name: string, args: LoadBalancerArgs, opts?: CustomResourceOptions);
    @overload
def LoadBalancer(resource_name: str,
                 args: LoadBalancerArgs,
                 opts: Optional[ResourceOptions] = None)

@overload
def LoadBalancer(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 listeners: Optional[Sequence[LoadBalancerListenersArgs]] = None,
                 lb_cookie_stickiness_policy: Optional[Sequence[LoadBalancerLbCookieStickinessPolicyArgs]] = None,
                 policies: Optional[Sequence[LoadBalancerPoliciesArgs]] = None,
                 connection_draining_policy: Optional[LoadBalancerConnectionDrainingPolicyArgs] = None,
                 connection_settings: Optional[LoadBalancerConnectionSettingsArgs] = None,
                 cross_zone: Optional[bool] = None,
                 health_check: Optional[LoadBalancerHealthCheckArgs] = None,
                 availability_zones: Optional[Sequence[str]] = None,
                 app_cookie_stickiness_policy: Optional[Sequence[LoadBalancerAppCookieStickinessPolicyArgs]] = None,
                 instances: Optional[Sequence[str]] = None,
                 load_balancer_name: Optional[str] = None,
                 access_logging_policy: Optional[LoadBalancerAccessLoggingPolicyArgs] = None,
                 scheme: Optional[str] = None,
                 security_groups: Optional[Sequence[str]] = None,
                 subnets: Optional[Sequence[str]] = None,
                 tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewLoadBalancer(ctx *Context, name string, args LoadBalancerArgs, opts ...ResourceOption) (*LoadBalancer, error)
    public LoadBalancer(string name, LoadBalancerArgs args, CustomResourceOptions? opts = null)
    public LoadBalancer(String name, LoadBalancerArgs args)
public LoadBalancer(String name, LoadBalancerArgs args, CustomResourceOptions options)

    type: aws-native:elasticloadbalancing:LoadBalancer
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "aws-native_elasticloadbalancing_loadbalancer" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args LoadBalancerArgs
    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 LoadBalancerArgs
    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 LoadBalancerArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args LoadBalancerArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args LoadBalancerArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    LoadBalancer 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 LoadBalancer resource accepts the following input properties:

    Listeners List<Pulumi.AwsNative.ElasticLoadBalancing.Inputs.LoadBalancerListeners>
    The Listeners for the load balancer. You can specify at most one listener per port.
    AccessLoggingPolicy Pulumi.AwsNative.ElasticLoadBalancing.Inputs.LoadBalancerAccessLoggingPolicy
    Information about where and how access logs are stored for the load balancer.
    AppCookieStickinessPolicy List<Pulumi.AwsNative.ElasticLoadBalancing.Inputs.LoadBalancerAppCookieStickinessPolicy>
    Information about a policy for application-controlled session stickiness.
    AvailabilityZones List<string>
    The Availability Zones for a load balancer in a default VPC. For a load balancer in a nondefault VPC, specify Subnets instead.
    ConnectionDrainingPolicy Pulumi.AwsNative.ElasticLoadBalancing.Inputs.LoadBalancerConnectionDrainingPolicy
    If enabled, the load balancer allows existing requests to complete before the load balancer shifts traffic away from a deregistered or unhealthy instance.
    ConnectionSettings Pulumi.AwsNative.ElasticLoadBalancing.Inputs.LoadBalancerConnectionSettings
    If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.
    CrossZone bool
    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.
    HealthCheck Pulumi.AwsNative.ElasticLoadBalancing.Inputs.LoadBalancerHealthCheck
    The health check settings to use when evaluating the health of your EC2 instances.
    Instances List<string>
    The IDs of the instances for the load balancer.
    LbCookieStickinessPolicy List<Pulumi.AwsNative.ElasticLoadBalancing.Inputs.LoadBalancerLbCookieStickinessPolicy>
    Information about a policy for duration-based session stickiness.
    LoadBalancerName string
    The name of the load balancer. This name must be unique within your set of load balancers for the region.
    Policies List<Pulumi.AwsNative.ElasticLoadBalancing.Inputs.LoadBalancerPolicies>
    The policies defined for your Classic Load Balancer. Specify only back-end server policies.
    Scheme string
    The type of load balancer. Valid only for load balancers in a VPC.
    SecurityGroups List<string>
    The security groups for the load balancer. Valid only for load balancers in a VPC.
    Subnets List<string>
    The IDs of the subnets for the load balancer. You can specify at most one subnet per Availability Zone.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    The tags associated with a load balancer.
    Listeners []LoadBalancerListenersArgs
    The Listeners for the load balancer. You can specify at most one listener per port.
    AccessLoggingPolicy LoadBalancerAccessLoggingPolicyArgs
    Information about where and how access logs are stored for the load balancer.
    AppCookieStickinessPolicy []LoadBalancerAppCookieStickinessPolicyArgs
    Information about a policy for application-controlled session stickiness.
    AvailabilityZones []string
    The Availability Zones for a load balancer in a default VPC. For a load balancer in a nondefault VPC, specify Subnets instead.
    ConnectionDrainingPolicy LoadBalancerConnectionDrainingPolicyArgs
    If enabled, the load balancer allows existing requests to complete before the load balancer shifts traffic away from a deregistered or unhealthy instance.
    ConnectionSettings LoadBalancerConnectionSettingsArgs
    If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.
    CrossZone bool
    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.
    HealthCheck LoadBalancerHealthCheckArgs
    The health check settings to use when evaluating the health of your EC2 instances.
    Instances []string
    The IDs of the instances for the load balancer.
    LbCookieStickinessPolicy []LoadBalancerLbCookieStickinessPolicyArgs
    Information about a policy for duration-based session stickiness.
    LoadBalancerName string
    The name of the load balancer. This name must be unique within your set of load balancers for the region.
    Policies []LoadBalancerPoliciesArgs
    The policies defined for your Classic Load Balancer. Specify only back-end server policies.
    Scheme string
    The type of load balancer. Valid only for load balancers in a VPC.
    SecurityGroups []string
    The security groups for the load balancer. Valid only for load balancers in a VPC.
    Subnets []string
    The IDs of the subnets for the load balancer. You can specify at most one subnet per Availability Zone.
    Tags TagArgs
    The tags associated with a load balancer.
    listeners list(object)
    The Listeners for the load balancer. You can specify at most one listener per port.
    access_logging_policy object
    Information about where and how access logs are stored for the load balancer.
    app_cookie_stickiness_policy list(object)
    Information about a policy for application-controlled session stickiness.
    availability_zones list(string)
    The Availability Zones for a load balancer in a default VPC. For a load balancer in a nondefault VPC, specify Subnets instead.
    connection_draining_policy object
    If enabled, the load balancer allows existing requests to complete before the load balancer shifts traffic away from a deregistered or unhealthy instance.
    connection_settings object
    If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.
    cross_zone bool
    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.
    health_check object
    The health check settings to use when evaluating the health of your EC2 instances.
    instances list(string)
    The IDs of the instances for the load balancer.
    lb_cookie_stickiness_policy list(object)
    Information about a policy for duration-based session stickiness.
    load_balancer_name string
    The name of the load balancer. This name must be unique within your set of load balancers for the region.
    policies list(object)
    The policies defined for your Classic Load Balancer. Specify only back-end server policies.
    scheme string
    The type of load balancer. Valid only for load balancers in a VPC.
    security_groups list(string)
    The security groups for the load balancer. Valid only for load balancers in a VPC.
    subnets list(string)
    The IDs of the subnets for the load balancer. You can specify at most one subnet per Availability Zone.
    tags list(object)
    The tags associated with a load balancer.
    listeners List<LoadBalancerListeners>
    The Listeners for the load balancer. You can specify at most one listener per port.
    accessLoggingPolicy LoadBalancerAccessLoggingPolicy
    Information about where and how access logs are stored for the load balancer.
    appCookieStickinessPolicy List<LoadBalancerAppCookieStickinessPolicy>
    Information about a policy for application-controlled session stickiness.
    availabilityZones List<String>
    The Availability Zones for a load balancer in a default VPC. For a load balancer in a nondefault VPC, specify Subnets instead.
    connectionDrainingPolicy LoadBalancerConnectionDrainingPolicy
    If enabled, the load balancer allows existing requests to complete before the load balancer shifts traffic away from a deregistered or unhealthy instance.
    connectionSettings LoadBalancerConnectionSettings
    If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.
    crossZone Boolean
    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.
    healthCheck LoadBalancerHealthCheck
    The health check settings to use when evaluating the health of your EC2 instances.
    instances List<String>
    The IDs of the instances for the load balancer.
    lbCookieStickinessPolicy List<LoadBalancerLbCookieStickinessPolicy>
    Information about a policy for duration-based session stickiness.
    loadBalancerName String
    The name of the load balancer. This name must be unique within your set of load balancers for the region.
    policies List<LoadBalancerPolicies>
    The policies defined for your Classic Load Balancer. Specify only back-end server policies.
    scheme String
    The type of load balancer. Valid only for load balancers in a VPC.
    securityGroups List<String>
    The security groups for the load balancer. Valid only for load balancers in a VPC.
    subnets List<String>
    The IDs of the subnets for the load balancer. You can specify at most one subnet per Availability Zone.
    tags List<Tag>
    The tags associated with a load balancer.
    listeners LoadBalancerListeners[]
    The Listeners for the load balancer. You can specify at most one listener per port.
    accessLoggingPolicy LoadBalancerAccessLoggingPolicy
    Information about where and how access logs are stored for the load balancer.
    appCookieStickinessPolicy LoadBalancerAppCookieStickinessPolicy[]
    Information about a policy for application-controlled session stickiness.
    availabilityZones string[]
    The Availability Zones for a load balancer in a default VPC. For a load balancer in a nondefault VPC, specify Subnets instead.
    connectionDrainingPolicy LoadBalancerConnectionDrainingPolicy
    If enabled, the load balancer allows existing requests to complete before the load balancer shifts traffic away from a deregistered or unhealthy instance.
    connectionSettings LoadBalancerConnectionSettings
    If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.
    crossZone boolean
    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.
    healthCheck LoadBalancerHealthCheck
    The health check settings to use when evaluating the health of your EC2 instances.
    instances string[]
    The IDs of the instances for the load balancer.
    lbCookieStickinessPolicy LoadBalancerLbCookieStickinessPolicy[]
    Information about a policy for duration-based session stickiness.
    loadBalancerName string
    The name of the load balancer. This name must be unique within your set of load balancers for the region.
    policies LoadBalancerPolicies[]
    The policies defined for your Classic Load Balancer. Specify only back-end server policies.
    scheme string
    The type of load balancer. Valid only for load balancers in a VPC.
    securityGroups string[]
    The security groups for the load balancer. Valid only for load balancers in a VPC.
    subnets string[]
    The IDs of the subnets for the load balancer. You can specify at most one subnet per Availability Zone.
    tags Tag[]
    The tags associated with a load balancer.
    listeners Sequence[LoadBalancerListenersArgs]
    The Listeners for the load balancer. You can specify at most one listener per port.
    access_logging_policy LoadBalancerAccessLoggingPolicyArgs
    Information about where and how access logs are stored for the load balancer.
    app_cookie_stickiness_policy Sequence[LoadBalancerAppCookieStickinessPolicyArgs]
    Information about a policy for application-controlled session stickiness.
    availability_zones Sequence[str]
    The Availability Zones for a load balancer in a default VPC. For a load balancer in a nondefault VPC, specify Subnets instead.
    connection_draining_policy LoadBalancerConnectionDrainingPolicyArgs
    If enabled, the load balancer allows existing requests to complete before the load balancer shifts traffic away from a deregistered or unhealthy instance.
    connection_settings LoadBalancerConnectionSettingsArgs
    If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.
    cross_zone bool
    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.
    health_check LoadBalancerHealthCheckArgs
    The health check settings to use when evaluating the health of your EC2 instances.
    instances Sequence[str]
    The IDs of the instances for the load balancer.
    lb_cookie_stickiness_policy Sequence[LoadBalancerLbCookieStickinessPolicyArgs]
    Information about a policy for duration-based session stickiness.
    load_balancer_name str
    The name of the load balancer. This name must be unique within your set of load balancers for the region.
    policies Sequence[LoadBalancerPoliciesArgs]
    The policies defined for your Classic Load Balancer. Specify only back-end server policies.
    scheme str
    The type of load balancer. Valid only for load balancers in a VPC.
    security_groups Sequence[str]
    The security groups for the load balancer. Valid only for load balancers in a VPC.
    subnets Sequence[str]
    The IDs of the subnets for the load balancer. You can specify at most one subnet per Availability Zone.
    tags Sequence[TagArgs]
    The tags associated with a load balancer.
    listeners List<Property Map>
    The Listeners for the load balancer. You can specify at most one listener per port.
    accessLoggingPolicy Property Map
    Information about where and how access logs are stored for the load balancer.
    appCookieStickinessPolicy List<Property Map>
    Information about a policy for application-controlled session stickiness.
    availabilityZones List<String>
    The Availability Zones for a load balancer in a default VPC. For a load balancer in a nondefault VPC, specify Subnets instead.
    connectionDrainingPolicy Property Map
    If enabled, the load balancer allows existing requests to complete before the load balancer shifts traffic away from a deregistered or unhealthy instance.
    connectionSettings Property Map
    If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.
    crossZone Boolean
    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.
    healthCheck Property Map
    The health check settings to use when evaluating the health of your EC2 instances.
    instances List<String>
    The IDs of the instances for the load balancer.
    lbCookieStickinessPolicy List<Property Map>
    Information about a policy for duration-based session stickiness.
    loadBalancerName String
    The name of the load balancer. This name must be unique within your set of load balancers for the region.
    policies List<Property Map>
    The policies defined for your Classic Load Balancer. Specify only back-end server policies.
    scheme String
    The type of load balancer. Valid only for load balancers in a VPC.
    securityGroups List<String>
    The security groups for the load balancer. Valid only for load balancers in a VPC.
    subnets List<String>
    The IDs of the subnets for the load balancer. You can specify at most one subnet per Availability Zone.
    tags List<Property Map>
    The tags associated with a load balancer.

    Outputs

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

    CanonicalHostedZoneName string
    The name of the Route 53 hosted zone that is associated with the load balancer. Internal-facing load balancers.
    CanonicalHostedZoneNameId string
    The ID of the Route 53 hosted zone name that is associated with the load balancer.
    DnsName string
    The DNS name for the load balancer
    Id string
    The provider-assigned unique ID for this managed resource.
    SourceSecurityGroup Pulumi.AwsNative.ElasticLoadBalancing.Outputs.LoadBalancerSourceSecurityGroup
    CanonicalHostedZoneName string
    The name of the Route 53 hosted zone that is associated with the load balancer. Internal-facing load balancers.
    CanonicalHostedZoneNameId string
    The ID of the Route 53 hosted zone name that is associated with the load balancer.
    DnsName string
    The DNS name for the load balancer
    Id string
    The provider-assigned unique ID for this managed resource.
    SourceSecurityGroup LoadBalancerSourceSecurityGroup
    canonical_hosted_zone_name string
    The name of the Route 53 hosted zone that is associated with the load balancer. Internal-facing load balancers.
    canonical_hosted_zone_name_id string
    The ID of the Route 53 hosted zone name that is associated with the load balancer.
    dns_name string
    The DNS name for the load balancer
    id string
    The provider-assigned unique ID for this managed resource.
    source_security_group object
    canonicalHostedZoneName String
    The name of the Route 53 hosted zone that is associated with the load balancer. Internal-facing load balancers.
    canonicalHostedZoneNameId String
    The ID of the Route 53 hosted zone name that is associated with the load balancer.
    dnsName String
    The DNS name for the load balancer
    id String
    The provider-assigned unique ID for this managed resource.
    sourceSecurityGroup LoadBalancerSourceSecurityGroup
    canonicalHostedZoneName string
    The name of the Route 53 hosted zone that is associated with the load balancer. Internal-facing load balancers.
    canonicalHostedZoneNameId string
    The ID of the Route 53 hosted zone name that is associated with the load balancer.
    dnsName string
    The DNS name for the load balancer
    id string
    The provider-assigned unique ID for this managed resource.
    sourceSecurityGroup LoadBalancerSourceSecurityGroup
    canonical_hosted_zone_name str
    The name of the Route 53 hosted zone that is associated with the load balancer. Internal-facing load balancers.
    canonical_hosted_zone_name_id str
    The ID of the Route 53 hosted zone name that is associated with the load balancer.
    dns_name str
    The DNS name for the load balancer
    id str
    The provider-assigned unique ID for this managed resource.
    source_security_group LoadBalancerSourceSecurityGroup
    canonicalHostedZoneName String
    The name of the Route 53 hosted zone that is associated with the load balancer. Internal-facing load balancers.
    canonicalHostedZoneNameId String
    The ID of the Route 53 hosted zone name that is associated with the load balancer.
    dnsName String
    The DNS name for the load balancer
    id String
    The provider-assigned unique ID for this managed resource.
    sourceSecurityGroup Property Map

    Supporting Types

    LoadBalancerAccessLoggingPolicy, LoadBalancerAccessLoggingPolicyArgs

    Information about where and how access logs are stored for the load balancer.
    Enabled bool
    Specifies whether access logs are enabled for the load balancer.
    S3BucketName string
    The name of the Amazon S3 bucket where the access logs are stored.
    EmitInterval int

    The interval for publishing the access logs. You can specify an interval of either 5 minutes or 60 minutes.

    Default: 60 minutes

    S3BucketPrefix string
    The logical hierarchy you created for your Amazon S3 bucket, for example my-bucket-prefix/prod. If the prefix is not provided, the log is placed at the root level of the bucket.
    Enabled bool
    Specifies whether access logs are enabled for the load balancer.
    S3BucketName string
    The name of the Amazon S3 bucket where the access logs are stored.
    EmitInterval int

    The interval for publishing the access logs. You can specify an interval of either 5 minutes or 60 minutes.

    Default: 60 minutes

    S3BucketPrefix string
    The logical hierarchy you created for your Amazon S3 bucket, for example my-bucket-prefix/prod. If the prefix is not provided, the log is placed at the root level of the bucket.
    enabled bool
    Specifies whether access logs are enabled for the load balancer.
    s3_bucket_name string
    The name of the Amazon S3 bucket where the access logs are stored.
    emit_interval number

    The interval for publishing the access logs. You can specify an interval of either 5 minutes or 60 minutes.

    Default: 60 minutes

    s3_bucket_prefix string
    The logical hierarchy you created for your Amazon S3 bucket, for example my-bucket-prefix/prod. If the prefix is not provided, the log is placed at the root level of the bucket.
    enabled Boolean
    Specifies whether access logs are enabled for the load balancer.
    s3BucketName String
    The name of the Amazon S3 bucket where the access logs are stored.
    emitInterval Integer

    The interval for publishing the access logs. You can specify an interval of either 5 minutes or 60 minutes.

    Default: 60 minutes

    s3BucketPrefix String
    The logical hierarchy you created for your Amazon S3 bucket, for example my-bucket-prefix/prod. If the prefix is not provided, the log is placed at the root level of the bucket.
    enabled boolean
    Specifies whether access logs are enabled for the load balancer.
    s3BucketName string
    The name of the Amazon S3 bucket where the access logs are stored.
    emitInterval number

    The interval for publishing the access logs. You can specify an interval of either 5 minutes or 60 minutes.

    Default: 60 minutes

    s3BucketPrefix string
    The logical hierarchy you created for your Amazon S3 bucket, for example my-bucket-prefix/prod. If the prefix is not provided, the log is placed at the root level of the bucket.
    enabled bool
    Specifies whether access logs are enabled for the load balancer.
    s3_bucket_name str
    The name of the Amazon S3 bucket where the access logs are stored.
    emit_interval int

    The interval for publishing the access logs. You can specify an interval of either 5 minutes or 60 minutes.

    Default: 60 minutes

    s3_bucket_prefix str
    The logical hierarchy you created for your Amazon S3 bucket, for example my-bucket-prefix/prod. If the prefix is not provided, the log is placed at the root level of the bucket.
    enabled Boolean
    Specifies whether access logs are enabled for the load balancer.
    s3BucketName String
    The name of the Amazon S3 bucket where the access logs are stored.
    emitInterval Number

    The interval for publishing the access logs. You can specify an interval of either 5 minutes or 60 minutes.

    Default: 60 minutes

    s3BucketPrefix String
    The logical hierarchy you created for your Amazon S3 bucket, for example my-bucket-prefix/prod. If the prefix is not provided, the log is placed at the root level of the bucket.

    LoadBalancerAppCookieStickinessPolicy, LoadBalancerAppCookieStickinessPolicyArgs

    Information about a policy for application-controlled session stickiness.
    CookieName string
    The name of the application cookie used for stickiness.
    PolicyName string
    The mnemonic name for the policy being created. The name must be unique within a set of policies for this load balancer.
    CookieName string
    The name of the application cookie used for stickiness.
    PolicyName string
    The mnemonic name for the policy being created. The name must be unique within a set of policies for this load balancer.
    cookie_name string
    The name of the application cookie used for stickiness.
    policy_name string
    The mnemonic name for the policy being created. The name must be unique within a set of policies for this load balancer.
    cookieName String
    The name of the application cookie used for stickiness.
    policyName String
    The mnemonic name for the policy being created. The name must be unique within a set of policies for this load balancer.
    cookieName string
    The name of the application cookie used for stickiness.
    policyName string
    The mnemonic name for the policy being created. The name must be unique within a set of policies for this load balancer.
    cookie_name str
    The name of the application cookie used for stickiness.
    policy_name str
    The mnemonic name for the policy being created. The name must be unique within a set of policies for this load balancer.
    cookieName String
    The name of the application cookie used for stickiness.
    policyName String
    The mnemonic name for the policy being created. The name must be unique within a set of policies for this load balancer.

    LoadBalancerConnectionDrainingPolicy, LoadBalancerConnectionDrainingPolicyArgs

    If enabled, the load balancer allows existing requests to complete before the load balancer shifts traffic away from a deregistered or unhealthy instance.
    Enabled bool
    Specifies whether connection draining is enabled for the load balancer.
    Timeout int
    The maximum time, in seconds, to keep the existing connections open before deregistering the instances.
    Enabled bool
    Specifies whether connection draining is enabled for the load balancer.
    Timeout int
    The maximum time, in seconds, to keep the existing connections open before deregistering the instances.
    enabled bool
    Specifies whether connection draining is enabled for the load balancer.
    timeout number
    The maximum time, in seconds, to keep the existing connections open before deregistering the instances.
    enabled Boolean
    Specifies whether connection draining is enabled for the load balancer.
    timeout Integer
    The maximum time, in seconds, to keep the existing connections open before deregistering the instances.
    enabled boolean
    Specifies whether connection draining is enabled for the load balancer.
    timeout number
    The maximum time, in seconds, to keep the existing connections open before deregistering the instances.
    enabled bool
    Specifies whether connection draining is enabled for the load balancer.
    timeout int
    The maximum time, in seconds, to keep the existing connections open before deregistering the instances.
    enabled Boolean
    Specifies whether connection draining is enabled for the load balancer.
    timeout Number
    The maximum time, in seconds, to keep the existing connections open before deregistering the instances.

    LoadBalancerConnectionSettings, LoadBalancerConnectionSettingsArgs

    If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.
    IdleTimeout int
    The time, in seconds, that the connection is allowed to be idle (no data has been sent over the connection) before it is closed by the load balancer.
    IdleTimeout int
    The time, in seconds, that the connection is allowed to be idle (no data has been sent over the connection) before it is closed by the load balancer.
    idle_timeout number
    The time, in seconds, that the connection is allowed to be idle (no data has been sent over the connection) before it is closed by the load balancer.
    idleTimeout Integer
    The time, in seconds, that the connection is allowed to be idle (no data has been sent over the connection) before it is closed by the load balancer.
    idleTimeout number
    The time, in seconds, that the connection is allowed to be idle (no data has been sent over the connection) before it is closed by the load balancer.
    idle_timeout int
    The time, in seconds, that the connection is allowed to be idle (no data has been sent over the connection) before it is closed by the load balancer.
    idleTimeout Number
    The time, in seconds, that the connection is allowed to be idle (no data has been sent over the connection) before it is closed by the load balancer.

    LoadBalancerHealthCheck, LoadBalancerHealthCheckArgs

    The health check settings to use when evaluating the health of your EC2 instances.

    Update requires replacement if you did not previously specify health check settings or if you are removing the health check settings. Otherwise, update requires no interruption.

    HealthyThreshold string
    The number of consecutive health checks successes required before moving the instance to the Healthy state.
    Interval string
    The approximate interval, in seconds, between health checks of an individual instance.
    Target string
    The instance being checked.
    Timeout string

    The amount of time, in seconds, during which no response means a failed health check.

    This value must be less than the Interval value.

    UnhealthyThreshold string
    The number of consecutive health check failures required before moving the instance to the Unhealthy state.
    HealthyThreshold string
    The number of consecutive health checks successes required before moving the instance to the Healthy state.
    Interval string
    The approximate interval, in seconds, between health checks of an individual instance.
    Target string
    The instance being checked.
    Timeout string

    The amount of time, in seconds, during which no response means a failed health check.

    This value must be less than the Interval value.

    UnhealthyThreshold string
    The number of consecutive health check failures required before moving the instance to the Unhealthy state.
    healthy_threshold string
    The number of consecutive health checks successes required before moving the instance to the Healthy state.
    interval string
    The approximate interval, in seconds, between health checks of an individual instance.
    target string
    The instance being checked.
    timeout string

    The amount of time, in seconds, during which no response means a failed health check.

    This value must be less than the Interval value.

    unhealthy_threshold string
    The number of consecutive health check failures required before moving the instance to the Unhealthy state.
    healthyThreshold String
    The number of consecutive health checks successes required before moving the instance to the Healthy state.
    interval String
    The approximate interval, in seconds, between health checks of an individual instance.
    target String
    The instance being checked.
    timeout String

    The amount of time, in seconds, during which no response means a failed health check.

    This value must be less than the Interval value.

    unhealthyThreshold String
    The number of consecutive health check failures required before moving the instance to the Unhealthy state.
    healthyThreshold string
    The number of consecutive health checks successes required before moving the instance to the Healthy state.
    interval string
    The approximate interval, in seconds, between health checks of an individual instance.
    target string
    The instance being checked.
    timeout string

    The amount of time, in seconds, during which no response means a failed health check.

    This value must be less than the Interval value.

    unhealthyThreshold string
    The number of consecutive health check failures required before moving the instance to the Unhealthy state.
    healthy_threshold str
    The number of consecutive health checks successes required before moving the instance to the Healthy state.
    interval str
    The approximate interval, in seconds, between health checks of an individual instance.
    target str
    The instance being checked.
    timeout str

    The amount of time, in seconds, during which no response means a failed health check.

    This value must be less than the Interval value.

    unhealthy_threshold str
    The number of consecutive health check failures required before moving the instance to the Unhealthy state.
    healthyThreshold String
    The number of consecutive health checks successes required before moving the instance to the Healthy state.
    interval String
    The approximate interval, in seconds, between health checks of an individual instance.
    target String
    The instance being checked.
    timeout String

    The amount of time, in seconds, during which no response means a failed health check.

    This value must be less than the Interval value.

    unhealthyThreshold String
    The number of consecutive health check failures required before moving the instance to the Unhealthy state.

    LoadBalancerLbCookieStickinessPolicy, LoadBalancerLbCookieStickinessPolicyArgs

    Information about a policy for duration-based session stickiness.
    CookieExpirationPeriod string
    The time period, in seconds, after which the cookie should be considered stale. If this parameter is not specified, the stickiness session lasts for the duration of the browser session.
    PolicyName string
    The name of the policy. This name must be unique within the set of policies for this load balancer.
    CookieExpirationPeriod string
    The time period, in seconds, after which the cookie should be considered stale. If this parameter is not specified, the stickiness session lasts for the duration of the browser session.
    PolicyName string
    The name of the policy. This name must be unique within the set of policies for this load balancer.
    cookie_expiration_period string
    The time period, in seconds, after which the cookie should be considered stale. If this parameter is not specified, the stickiness session lasts for the duration of the browser session.
    policy_name string
    The name of the policy. This name must be unique within the set of policies for this load balancer.
    cookieExpirationPeriod String
    The time period, in seconds, after which the cookie should be considered stale. If this parameter is not specified, the stickiness session lasts for the duration of the browser session.
    policyName String
    The name of the policy. This name must be unique within the set of policies for this load balancer.
    cookieExpirationPeriod string
    The time period, in seconds, after which the cookie should be considered stale. If this parameter is not specified, the stickiness session lasts for the duration of the browser session.
    policyName string
    The name of the policy. This name must be unique within the set of policies for this load balancer.
    cookie_expiration_period str
    The time period, in seconds, after which the cookie should be considered stale. If this parameter is not specified, the stickiness session lasts for the duration of the browser session.
    policy_name str
    The name of the policy. This name must be unique within the set of policies for this load balancer.
    cookieExpirationPeriod String
    The time period, in seconds, after which the cookie should be considered stale. If this parameter is not specified, the stickiness session lasts for the duration of the browser session.
    policyName String
    The name of the policy. This name must be unique within the set of policies for this load balancer.

    LoadBalancerListeners, LoadBalancerListenersArgs

    InstancePort string
    The port on which the instance is listening.
    LoadBalancerPort string
    The port on which the load balancer is listening. On EC2-VPC, you can specify any port from the range 1-65535. On EC2-Classic, you can specify any port from the following list: 25, 80, 443, 465, 587, 1024-65535.
    Protocol string
    The load balancer transport protocol to use for routing: HTTP, HTTPS, TCP, or SSL.
    InstanceProtocol string

    The protocol to use for routing traffic to instances: HTTP, HTTPS, TCP, or SSL.

    If the front-end protocol is TCP or SSL, the back-end protocol must be TCP or SSL. If the front-end protocol is HTTP or HTTPS, the back-end protocol must be HTTP or HTTPS.

    If there is another listener with the same InstancePort whose InstanceProtocol is secure, (HTTPS or SSL), the listener's InstanceProtocol must also be secure.

    If there is another listener with the same InstancePort whose InstanceProtocol is HTTP or TCP, the listener's InstanceProtocol must be HTTP or TCP.

    PolicyNames List<string>
    The names of the policies to associate with the listener.
    SslCertificateId string
    The Amazon Resource Name (ARN) of the server certificate.
    InstancePort string
    The port on which the instance is listening.
    LoadBalancerPort string
    The port on which the load balancer is listening. On EC2-VPC, you can specify any port from the range 1-65535. On EC2-Classic, you can specify any port from the following list: 25, 80, 443, 465, 587, 1024-65535.
    Protocol string
    The load balancer transport protocol to use for routing: HTTP, HTTPS, TCP, or SSL.
    InstanceProtocol string

    The protocol to use for routing traffic to instances: HTTP, HTTPS, TCP, or SSL.

    If the front-end protocol is TCP or SSL, the back-end protocol must be TCP or SSL. If the front-end protocol is HTTP or HTTPS, the back-end protocol must be HTTP or HTTPS.

    If there is another listener with the same InstancePort whose InstanceProtocol is secure, (HTTPS or SSL), the listener's InstanceProtocol must also be secure.

    If there is another listener with the same InstancePort whose InstanceProtocol is HTTP or TCP, the listener's InstanceProtocol must be HTTP or TCP.

    PolicyNames []string
    The names of the policies to associate with the listener.
    SslCertificateId string
    The Amazon Resource Name (ARN) of the server certificate.
    instance_port string
    The port on which the instance is listening.
    load_balancer_port string
    The port on which the load balancer is listening. On EC2-VPC, you can specify any port from the range 1-65535. On EC2-Classic, you can specify any port from the following list: 25, 80, 443, 465, 587, 1024-65535.
    protocol string
    The load balancer transport protocol to use for routing: HTTP, HTTPS, TCP, or SSL.
    instance_protocol string

    The protocol to use for routing traffic to instances: HTTP, HTTPS, TCP, or SSL.

    If the front-end protocol is TCP or SSL, the back-end protocol must be TCP or SSL. If the front-end protocol is HTTP or HTTPS, the back-end protocol must be HTTP or HTTPS.

    If there is another listener with the same InstancePort whose InstanceProtocol is secure, (HTTPS or SSL), the listener's InstanceProtocol must also be secure.

    If there is another listener with the same InstancePort whose InstanceProtocol is HTTP or TCP, the listener's InstanceProtocol must be HTTP or TCP.

    policy_names list(string)
    The names of the policies to associate with the listener.
    ssl_certificate_id string
    The Amazon Resource Name (ARN) of the server certificate.
    instancePort String
    The port on which the instance is listening.
    loadBalancerPort String
    The port on which the load balancer is listening. On EC2-VPC, you can specify any port from the range 1-65535. On EC2-Classic, you can specify any port from the following list: 25, 80, 443, 465, 587, 1024-65535.
    protocol String
    The load balancer transport protocol to use for routing: HTTP, HTTPS, TCP, or SSL.
    instanceProtocol String

    The protocol to use for routing traffic to instances: HTTP, HTTPS, TCP, or SSL.

    If the front-end protocol is TCP or SSL, the back-end protocol must be TCP or SSL. If the front-end protocol is HTTP or HTTPS, the back-end protocol must be HTTP or HTTPS.

    If there is another listener with the same InstancePort whose InstanceProtocol is secure, (HTTPS or SSL), the listener's InstanceProtocol must also be secure.

    If there is another listener with the same InstancePort whose InstanceProtocol is HTTP or TCP, the listener's InstanceProtocol must be HTTP or TCP.

    policyNames List<String>
    The names of the policies to associate with the listener.
    sslCertificateId String
    The Amazon Resource Name (ARN) of the server certificate.
    instancePort string
    The port on which the instance is listening.
    loadBalancerPort string
    The port on which the load balancer is listening. On EC2-VPC, you can specify any port from the range 1-65535. On EC2-Classic, you can specify any port from the following list: 25, 80, 443, 465, 587, 1024-65535.
    protocol string
    The load balancer transport protocol to use for routing: HTTP, HTTPS, TCP, or SSL.
    instanceProtocol string

    The protocol to use for routing traffic to instances: HTTP, HTTPS, TCP, or SSL.

    If the front-end protocol is TCP or SSL, the back-end protocol must be TCP or SSL. If the front-end protocol is HTTP or HTTPS, the back-end protocol must be HTTP or HTTPS.

    If there is another listener with the same InstancePort whose InstanceProtocol is secure, (HTTPS or SSL), the listener's InstanceProtocol must also be secure.

    If there is another listener with the same InstancePort whose InstanceProtocol is HTTP or TCP, the listener's InstanceProtocol must be HTTP or TCP.

    policyNames string[]
    The names of the policies to associate with the listener.
    sslCertificateId string
    The Amazon Resource Name (ARN) of the server certificate.
    instance_port str
    The port on which the instance is listening.
    load_balancer_port str
    The port on which the load balancer is listening. On EC2-VPC, you can specify any port from the range 1-65535. On EC2-Classic, you can specify any port from the following list: 25, 80, 443, 465, 587, 1024-65535.
    protocol str
    The load balancer transport protocol to use for routing: HTTP, HTTPS, TCP, or SSL.
    instance_protocol str

    The protocol to use for routing traffic to instances: HTTP, HTTPS, TCP, or SSL.

    If the front-end protocol is TCP or SSL, the back-end protocol must be TCP or SSL. If the front-end protocol is HTTP or HTTPS, the back-end protocol must be HTTP or HTTPS.

    If there is another listener with the same InstancePort whose InstanceProtocol is secure, (HTTPS or SSL), the listener's InstanceProtocol must also be secure.

    If there is another listener with the same InstancePort whose InstanceProtocol is HTTP or TCP, the listener's InstanceProtocol must be HTTP or TCP.

    policy_names Sequence[str]
    The names of the policies to associate with the listener.
    ssl_certificate_id str
    The Amazon Resource Name (ARN) of the server certificate.
    instancePort String
    The port on which the instance is listening.
    loadBalancerPort String
    The port on which the load balancer is listening. On EC2-VPC, you can specify any port from the range 1-65535. On EC2-Classic, you can specify any port from the following list: 25, 80, 443, 465, 587, 1024-65535.
    protocol String
    The load balancer transport protocol to use for routing: HTTP, HTTPS, TCP, or SSL.
    instanceProtocol String

    The protocol to use for routing traffic to instances: HTTP, HTTPS, TCP, or SSL.

    If the front-end protocol is TCP or SSL, the back-end protocol must be TCP or SSL. If the front-end protocol is HTTP or HTTPS, the back-end protocol must be HTTP or HTTPS.

    If there is another listener with the same InstancePort whose InstanceProtocol is secure, (HTTPS or SSL), the listener's InstanceProtocol must also be secure.

    If there is another listener with the same InstancePort whose InstanceProtocol is HTTP or TCP, the listener's InstanceProtocol must be HTTP or TCP.

    policyNames List<String>
    The names of the policies to associate with the listener.
    sslCertificateId String
    The Amazon Resource Name (ARN) of the server certificate.

    LoadBalancerPolicies, LoadBalancerPoliciesArgs

    Attributes List<Pulumi.AwsNative.ElasticLoadBalancing.Inputs.LoadBalancerPolicyItem>
    The policy attributes.
    PolicyName string
    The name of the policy.
    PolicyType string
    The name of the policy type.
    InstancePorts List<string>
    The instance ports for the policy. Required only for some policy types.
    LoadBalancerPorts List<string>
    The load balancer ports for the policy. Required only for some policy types.
    Attributes []LoadBalancerPolicyItem
    The policy attributes.
    PolicyName string
    The name of the policy.
    PolicyType string
    The name of the policy type.
    InstancePorts []string
    The instance ports for the policy. Required only for some policy types.
    LoadBalancerPorts []string
    The load balancer ports for the policy. Required only for some policy types.
    attributes list(object)
    The policy attributes.
    policy_name string
    The name of the policy.
    policy_type string
    The name of the policy type.
    instance_ports list(string)
    The instance ports for the policy. Required only for some policy types.
    load_balancer_ports list(string)
    The load balancer ports for the policy. Required only for some policy types.
    attributes List<LoadBalancerPolicyItem>
    The policy attributes.
    policyName String
    The name of the policy.
    policyType String
    The name of the policy type.
    instancePorts List<String>
    The instance ports for the policy. Required only for some policy types.
    loadBalancerPorts List<String>
    The load balancer ports for the policy. Required only for some policy types.
    attributes LoadBalancerPolicyItem[]
    The policy attributes.
    policyName string
    The name of the policy.
    policyType string
    The name of the policy type.
    instancePorts string[]
    The instance ports for the policy. Required only for some policy types.
    loadBalancerPorts string[]
    The load balancer ports for the policy. Required only for some policy types.
    attributes Sequence[LoadBalancerPolicyItem]
    The policy attributes.
    policy_name str
    The name of the policy.
    policy_type str
    The name of the policy type.
    instance_ports Sequence[str]
    The instance ports for the policy. Required only for some policy types.
    load_balancer_ports Sequence[str]
    The load balancer ports for the policy. Required only for some policy types.
    attributes List<Property Map>
    The policy attributes.
    policyName String
    The name of the policy.
    policyType String
    The name of the policy type.
    instancePorts List<String>
    The instance ports for the policy. Required only for some policy types.
    loadBalancerPorts List<String>
    The load balancer ports for the policy. Required only for some policy types.

    LoadBalancerPolicyItem, LoadBalancerPolicyItemArgs

    Name string
    Value string
    Name string
    Value string
    name string
    value string
    name String
    value String
    name string
    value string
    name str
    value str
    name String
    value String

    LoadBalancerSourceSecurityGroup, LoadBalancerSourceSecurityGroupArgs

    GroupName string
    The name of the security group that you can use as part of your inbound rules for your load balancer's back-end instances.
    OwnerAlias string
    The owner of the source security group.
    GroupName string
    The name of the security group that you can use as part of your inbound rules for your load balancer's back-end instances.
    OwnerAlias string
    The owner of the source security group.
    group_name string
    The name of the security group that you can use as part of your inbound rules for your load balancer's back-end instances.
    owner_alias string
    The owner of the source security group.
    groupName String
    The name of the security group that you can use as part of your inbound rules for your load balancer's back-end instances.
    ownerAlias String
    The owner of the source security group.
    groupName string
    The name of the security group that you can use as part of your inbound rules for your load balancer's back-end instances.
    ownerAlias string
    The owner of the source security group.
    group_name str
    The name of the security group that you can use as part of your inbound rules for your load balancer's back-end instances.
    owner_alias str
    The owner of the source security group.
    groupName String
    The name of the security group that you can use as part of your inbound rules for your load balancer's back-end instances.
    ownerAlias String
    The owner of the source security group.

    Tag, TagArgs

    A set of tags to apply to the resource.
    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.69.0
    published on Monday, Jun 15, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws-native

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial