1. Packages
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. elasticloadbalancing
  6. getLoadBalancer

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

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

aws-native.elasticloadbalancing.getLoadBalancer

aws-native logo

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

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

    Resource Type definition for AWS::ElasticLoadBalancing::LoadBalancer

    Using getLoadBalancer

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getLoadBalancer(args: GetLoadBalancerArgs, opts?: InvokeOptions): Promise<GetLoadBalancerResult>
function getLoadBalancerOutput(args: GetLoadBalancerOutputArgs, opts?: InvokeOptions): Output<GetLoadBalancerResult>
    def get_load_balancer(id: Optional[str] = None,
                      opts: Optional[InvokeOptions] = None) -> GetLoadBalancerResult
def get_load_balancer_output(id: Optional[pulumi.Input[str]] = None,
                      opts: Optional[InvokeOptions] = None) -> Output[GetLoadBalancerResult]
    func LookupLoadBalancer(ctx *Context, args *LookupLoadBalancerArgs, opts ...InvokeOption) (*LookupLoadBalancerResult, error)
func LookupLoadBalancerOutput(ctx *Context, args *LookupLoadBalancerOutputArgs, opts ...InvokeOption) LookupLoadBalancerResultOutput

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

    public static class GetLoadBalancer 
{
    public static Task<GetLoadBalancerResult> InvokeAsync(GetLoadBalancerArgs args, InvokeOptions? opts = null)
    public static Output<GetLoadBalancerResult> Invoke(GetLoadBalancerInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetLoadBalancerResult> getLoadBalancer(GetLoadBalancerArgs args, InvokeOptions options)
public static Output<GetLoadBalancerResult> getLoadBalancer(GetLoadBalancerArgs args, InvokeOptions options)

    fn::invoke:
  function: aws-native:elasticloadbalancing:getLoadBalancer
  arguments:
    # arguments dictionary

    The following arguments are supported:

    Id string
    Id string
    id String
    id string
    id str
    id String

    getLoadBalancer Result

    The following output properties are available:

    AccessLoggingPolicy Pulumi.AwsNative.ElasticLoadBalancing.Outputs.LoadBalancerAccessLoggingPolicy
    Information about where and how access logs are stored for the load balancer.
    AppCookieStickinessPolicy List<Pulumi.AwsNative.ElasticLoadBalancing.Outputs.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.

    Update requires replacement if you did not previously specify an Availability Zone or if you are removing all Availability Zones. Otherwise, update requires no interruption.

    CanonicalHostedZoneName string
    The name of the Route 53 hosted zone that is associated with the load balancer. Internal-facing load balancers don't use this value, use DNSName instead.
    CanonicalHostedZoneNameId string
    The ID of the Route 53 hosted zone name that is associated with the load balancer.
    ConnectionDrainingPolicy Pulumi.AwsNative.ElasticLoadBalancing.Outputs.LoadBalancerConnectionDrainingPolicy

    If enabled, the load balancer allows existing requests to complete before the load balancer shifts traffic away from a deregistered or unhealthy instance.

    For more information, see Configure connection draining in the User Guide for Classic Load Balancers .

    ConnectionSettings Pulumi.AwsNative.ElasticLoadBalancing.Outputs.LoadBalancerConnectionSettings

    If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.

    By default, Elastic Load Balancing maintains a 60-second idle connection timeout for both front-end and back-end connections of your load balancer. For more information, see Configure idle connection timeout in the User Guide for Classic Load Balancers .

    CrossZone bool

    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.

    For more information, see Configure cross-zone load balancing in the User Guide for Classic Load Balancers .

    DnsName string
    The DNS name for the load balancer.
    HealthCheck Pulumi.AwsNative.ElasticLoadBalancing.Outputs.LoadBalancerHealthCheck

    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.

    Id string
    Instances List<string>
    The IDs of the instances for the load balancer.
    LbCookieStickinessPolicy List<Pulumi.AwsNative.ElasticLoadBalancing.Outputs.LoadBalancerLbCookieStickinessPolicy>
    Information about a policy for duration-based session stickiness.
    Listeners List<Pulumi.AwsNative.ElasticLoadBalancing.Outputs.LoadBalancerListeners>

    The listeners for the load balancer. You can specify at most one listener per port.

    If you update the properties for a listener, AWS CloudFormation deletes the existing listener and creates a new one with the specified properties. While the new listener is being created, clients cannot connect to the load balancer.

    Policies List<Pulumi.AwsNative.ElasticLoadBalancing.Outputs.LoadBalancerPolicies>
    The policies defined for your Classic Load Balancer. Specify only back-end server policies.
    SecurityGroups List<string>
    The security groups for the load balancer. Valid only for load balancers in a VPC.
    SourceSecurityGroupGroupName string
    SourceSecurityGroupOwnerAlias string
    Subnets List<string>

    The IDs of the subnets for the load balancer. You can specify at most one subnet per Availability Zone.

    Update requires replacement if you did not previously specify a subnet or if you are removing all subnets. Otherwise, update requires no interruption. To update to a different subnet in the current Availability Zone, you must first update to a subnet in a different Availability Zone, then update to the new subnet in the original Availability Zone.

    Tags List<Pulumi.AwsNative.Outputs.Tag>
    The tags associated with a load balancer.
    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.

    Update requires replacement if you did not previously specify an Availability Zone or if you are removing all Availability Zones. Otherwise, update requires no interruption.

    CanonicalHostedZoneName string
    The name of the Route 53 hosted zone that is associated with the load balancer. Internal-facing load balancers don't use this value, use DNSName instead.
    CanonicalHostedZoneNameId string
    The ID of the Route 53 hosted zone name that is associated with the load balancer.
    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.

    For more information, see Configure connection draining in the User Guide for Classic Load Balancers .

    ConnectionSettings LoadBalancerConnectionSettings

    If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.

    By default, Elastic Load Balancing maintains a 60-second idle connection timeout for both front-end and back-end connections of your load balancer. For more information, see Configure idle connection timeout in the User Guide for Classic Load Balancers .

    CrossZone bool

    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.

    For more information, see Configure cross-zone load balancing in the User Guide for Classic Load Balancers .

    DnsName string
    The DNS name for the load balancer.
    HealthCheck LoadBalancerHealthCheck

    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.

    Id string
    Instances []string
    The IDs of the instances for the load balancer.
    LbCookieStickinessPolicy []LoadBalancerLbCookieStickinessPolicy
    Information about a policy for duration-based session stickiness.
    Listeners []LoadBalancerListeners

    The listeners for the load balancer. You can specify at most one listener per port.

    If you update the properties for a listener, AWS CloudFormation deletes the existing listener and creates a new one with the specified properties. While the new listener is being created, clients cannot connect to the load balancer.

    Policies []LoadBalancerPolicies
    The policies defined for your Classic Load Balancer. Specify only back-end server policies.
    SecurityGroups []string
    The security groups for the load balancer. Valid only for load balancers in a VPC.
    SourceSecurityGroupGroupName string
    SourceSecurityGroupOwnerAlias string
    Subnets []string

    The IDs of the subnets for the load balancer. You can specify at most one subnet per Availability Zone.

    Update requires replacement if you did not previously specify a subnet or if you are removing all subnets. Otherwise, update requires no interruption. To update to a different subnet in the current Availability Zone, you must first update to a subnet in a different Availability Zone, then update to the new subnet in the original Availability Zone.

    Tags Tag
    The tags associated with a load balancer.
    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.

    Update requires replacement if you did not previously specify an Availability Zone or if you are removing all Availability Zones. Otherwise, update requires no interruption.

    canonicalHostedZoneName String
    The name of the Route 53 hosted zone that is associated with the load balancer. Internal-facing load balancers don't use this value, use DNSName instead.
    canonicalHostedZoneNameId String
    The ID of the Route 53 hosted zone name that is associated with the load balancer.
    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.

    For more information, see Configure connection draining in the User Guide for Classic Load Balancers .

    connectionSettings LoadBalancerConnectionSettings

    If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.

    By default, Elastic Load Balancing maintains a 60-second idle connection timeout for both front-end and back-end connections of your load balancer. For more information, see Configure idle connection timeout in the User Guide for Classic Load Balancers .

    crossZone Boolean

    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.

    For more information, see Configure cross-zone load balancing in the User Guide for Classic Load Balancers .

    dnsName String
    The DNS name for the load balancer.
    healthCheck LoadBalancerHealthCheck

    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.

    id String
    instances List<String>
    The IDs of the instances for the load balancer.
    lbCookieStickinessPolicy List<LoadBalancerLbCookieStickinessPolicy>
    Information about a policy for duration-based session stickiness.
    listeners List<LoadBalancerListeners>

    The listeners for the load balancer. You can specify at most one listener per port.

    If you update the properties for a listener, AWS CloudFormation deletes the existing listener and creates a new one with the specified properties. While the new listener is being created, clients cannot connect to the load balancer.

    policies List<LoadBalancerPolicies>
    The policies defined for your Classic Load Balancer. Specify only back-end server policies.
    securityGroups List<String>
    The security groups for the load balancer. Valid only for load balancers in a VPC.
    sourceSecurityGroupGroupName String
    sourceSecurityGroupOwnerAlias String
    subnets List<String>

    The IDs of the subnets for the load balancer. You can specify at most one subnet per Availability Zone.

    Update requires replacement if you did not previously specify a subnet or if you are removing all subnets. Otherwise, update requires no interruption. To update to a different subnet in the current Availability Zone, you must first update to a subnet in a different Availability Zone, then update to the new subnet in the original Availability Zone.

    tags List<Tag>
    The tags associated with a load balancer.
    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.

    Update requires replacement if you did not previously specify an Availability Zone or if you are removing all Availability Zones. Otherwise, update requires no interruption.

    canonicalHostedZoneName string
    The name of the Route 53 hosted zone that is associated with the load balancer. Internal-facing load balancers don't use this value, use DNSName instead.
    canonicalHostedZoneNameId string
    The ID of the Route 53 hosted zone name that is associated with the load balancer.
    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.

    For more information, see Configure connection draining in the User Guide for Classic Load Balancers .

    connectionSettings LoadBalancerConnectionSettings

    If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.

    By default, Elastic Load Balancing maintains a 60-second idle connection timeout for both front-end and back-end connections of your load balancer. For more information, see Configure idle connection timeout in the User Guide for Classic Load Balancers .

    crossZone boolean

    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.

    For more information, see Configure cross-zone load balancing in the User Guide for Classic Load Balancers .

    dnsName string
    The DNS name for the load balancer.
    healthCheck LoadBalancerHealthCheck

    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.

    id string
    instances string[]
    The IDs of the instances for the load balancer.
    lbCookieStickinessPolicy LoadBalancerLbCookieStickinessPolicy[]
    Information about a policy for duration-based session stickiness.
    listeners LoadBalancerListeners[]

    The listeners for the load balancer. You can specify at most one listener per port.

    If you update the properties for a listener, AWS CloudFormation deletes the existing listener and creates a new one with the specified properties. While the new listener is being created, clients cannot connect to the load balancer.

    policies LoadBalancerPolicies[]
    The policies defined for your Classic Load Balancer. Specify only back-end server policies.
    securityGroups string[]
    The security groups for the load balancer. Valid only for load balancers in a VPC.
    sourceSecurityGroupGroupName string
    sourceSecurityGroupOwnerAlias string
    subnets string[]

    The IDs of the subnets for the load balancer. You can specify at most one subnet per Availability Zone.

    Update requires replacement if you did not previously specify a subnet or if you are removing all subnets. Otherwise, update requires no interruption. To update to a different subnet in the current Availability Zone, you must first update to a subnet in a different Availability Zone, then update to the new subnet in the original Availability Zone.

    tags Tag[]
    The tags associated with a load balancer.
    access_logging_policy LoadBalancerAccessLoggingPolicy
    Information about where and how access logs are stored for the load balancer.
    app_cookie_stickiness_policy Sequence[LoadBalancerAppCookieStickinessPolicy]
    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.

    Update requires replacement if you did not previously specify an Availability Zone or if you are removing all Availability Zones. Otherwise, update requires no interruption.

    canonical_hosted_zone_name str
    The name of the Route 53 hosted zone that is associated with the load balancer. Internal-facing load balancers don't use this value, use DNSName instead.
    canonical_hosted_zone_name_id str
    The ID of the Route 53 hosted zone name that is associated with the load balancer.
    connection_draining_policy LoadBalancerConnectionDrainingPolicy

    If enabled, the load balancer allows existing requests to complete before the load balancer shifts traffic away from a deregistered or unhealthy instance.

    For more information, see Configure connection draining in the User Guide for Classic Load Balancers .

    connection_settings LoadBalancerConnectionSettings

    If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.

    By default, Elastic Load Balancing maintains a 60-second idle connection timeout for both front-end and back-end connections of your load balancer. For more information, see Configure idle connection timeout in the User Guide for Classic Load Balancers .

    cross_zone bool

    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.

    For more information, see Configure cross-zone load balancing in the User Guide for Classic Load Balancers .

    dns_name str
    The DNS name for the load balancer.
    health_check LoadBalancerHealthCheck

    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.

    id str
    instances Sequence[str]
    The IDs of the instances for the load balancer.
    lb_cookie_stickiness_policy Sequence[LoadBalancerLbCookieStickinessPolicy]
    Information about a policy for duration-based session stickiness.
    listeners Sequence[LoadBalancerListeners]

    The listeners for the load balancer. You can specify at most one listener per port.

    If you update the properties for a listener, AWS CloudFormation deletes the existing listener and creates a new one with the specified properties. While the new listener is being created, clients cannot connect to the load balancer.

    policies Sequence[LoadBalancerPolicies]
    The policies defined for your Classic Load Balancer. Specify only back-end server policies.
    security_groups Sequence[str]
    The security groups for the load balancer. Valid only for load balancers in a VPC.
    source_security_group_group_name str
    source_security_group_owner_alias str
    subnets Sequence[str]

    The IDs of the subnets for the load balancer. You can specify at most one subnet per Availability Zone.

    Update requires replacement if you did not previously specify a subnet or if you are removing all subnets. Otherwise, update requires no interruption. To update to a different subnet in the current Availability Zone, you must first update to a subnet in a different Availability Zone, then update to the new subnet in the original Availability Zone.

    tags Sequence[root_Tag]
    The tags associated with a load balancer.
    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.

    Update requires replacement if you did not previously specify an Availability Zone or if you are removing all Availability Zones. Otherwise, update requires no interruption.

    canonicalHostedZoneName String
    The name of the Route 53 hosted zone that is associated with the load balancer. Internal-facing load balancers don't use this value, use DNSName instead.
    canonicalHostedZoneNameId String
    The ID of the Route 53 hosted zone name that is associated with the load balancer.
    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.

    For more information, see Configure connection draining in the User Guide for Classic Load Balancers .

    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.

    By default, Elastic Load Balancing maintains a 60-second idle connection timeout for both front-end and back-end connections of your load balancer. For more information, see Configure idle connection timeout in the User Guide for Classic Load Balancers .

    crossZone Boolean

    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.

    For more information, see Configure cross-zone load balancing in the User Guide for Classic Load Balancers .

    dnsName String
    The DNS name for the load balancer.
    healthCheck Property Map

    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.

    id String
    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.
    listeners List<Property Map>

    The listeners for the load balancer. You can specify at most one listener per port.

    If you update the properties for a listener, AWS CloudFormation deletes the existing listener and creates a new one with the specified properties. While the new listener is being created, clients cannot connect to the load balancer.

    policies List<Property Map>
    The policies defined for your Classic Load Balancer. Specify only back-end server policies.
    securityGroups List<String>
    The security groups for the load balancer. Valid only for load balancers in a VPC.
    sourceSecurityGroupGroupName String
    sourceSecurityGroupOwnerAlias String
    subnets List<String>

    The IDs of the subnets for the load balancer. You can specify at most one subnet per Availability Zone.

    Update requires replacement if you did not previously specify a subnet or if you are removing all subnets. Otherwise, update requires no interruption. To update to a different subnet in the current Availability Zone, you must first update to a subnet in a different Availability Zone, then update to the new subnet in the original Availability Zone.

    tags List<Property Map>
    The tags associated with a load balancer.

    Supporting Types

    LoadBalancerAccessLoggingPolicy

    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 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

    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.
    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

    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 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

    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.
    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

    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. The protocol is either TCP, HTTP, HTTPS, or SSL. The range of valid ports is one (1) through 65535.

    TCP is the default, specified as a TCP: port pair, for example "TCP:5000". In this case, a health check simply attempts to open a TCP connection to the instance on the specified port. Failure to connect within the configured timeout is considered unhealthy.

    SSL is also specified as SSL: port pair, for example, SSL:5000.

    For HTTP/HTTPS, you must include a ping path in the string. HTTP is specified as a HTTP:port;/;PathToPing; grouping, for example "HTTP:80/weather/us/wa/seattle". In this case, a HTTP GET request is issued to the instance on the given port and path. Any answer other than "200 OK" within the timeout period is considered unhealthy.

    The total length of the HTTP ping target must be 1024 16-bit Unicode characters or less.

    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. The protocol is either TCP, HTTP, HTTPS, or SSL. The range of valid ports is one (1) through 65535.

    TCP is the default, specified as a TCP: port pair, for example "TCP:5000". In this case, a health check simply attempts to open a TCP connection to the instance on the specified port. Failure to connect within the configured timeout is considered unhealthy.

    SSL is also specified as SSL: port pair, for example, SSL:5000.

    For HTTP/HTTPS, you must include a ping path in the string. HTTP is specified as a HTTP:port;/;PathToPing; grouping, for example "HTTP:80/weather/us/wa/seattle". In this case, a HTTP GET request is issued to the instance on the given port and path. Any answer other than "200 OK" within the timeout period is considered unhealthy.

    The total length of the HTTP ping target must be 1024 16-bit Unicode characters or less.

    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. The protocol is either TCP, HTTP, HTTPS, or SSL. The range of valid ports is one (1) through 65535.

    TCP is the default, specified as a TCP: port pair, for example "TCP:5000". In this case, a health check simply attempts to open a TCP connection to the instance on the specified port. Failure to connect within the configured timeout is considered unhealthy.

    SSL is also specified as SSL: port pair, for example, SSL:5000.

    For HTTP/HTTPS, you must include a ping path in the string. HTTP is specified as a HTTP:port;/;PathToPing; grouping, for example "HTTP:80/weather/us/wa/seattle". In this case, a HTTP GET request is issued to the instance on the given port and path. Any answer other than "200 OK" within the timeout period is considered unhealthy.

    The total length of the HTTP ping target must be 1024 16-bit Unicode characters or less.

    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. The protocol is either TCP, HTTP, HTTPS, or SSL. The range of valid ports is one (1) through 65535.

    TCP is the default, specified as a TCP: port pair, for example "TCP:5000". In this case, a health check simply attempts to open a TCP connection to the instance on the specified port. Failure to connect within the configured timeout is considered unhealthy.

    SSL is also specified as SSL: port pair, for example, SSL:5000.

    For HTTP/HTTPS, you must include a ping path in the string. HTTP is specified as a HTTP:port;/;PathToPing; grouping, for example "HTTP:80/weather/us/wa/seattle". In this case, a HTTP GET request is issued to the instance on the given port and path. Any answer other than "200 OK" within the timeout period is considered unhealthy.

    The total length of the HTTP ping target must be 1024 16-bit Unicode characters or less.

    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. The protocol is either TCP, HTTP, HTTPS, or SSL. The range of valid ports is one (1) through 65535.

    TCP is the default, specified as a TCP: port pair, for example "TCP:5000". In this case, a health check simply attempts to open a TCP connection to the instance on the specified port. Failure to connect within the configured timeout is considered unhealthy.

    SSL is also specified as SSL: port pair, for example, SSL:5000.

    For HTTP/HTTPS, you must include a ping path in the string. HTTP is specified as a HTTP:port;/;PathToPing; grouping, for example "HTTP:80/weather/us/wa/seattle". In this case, a HTTP GET request is issued to the instance on the given port and path. Any answer other than "200 OK" within the timeout period is considered unhealthy.

    The total length of the HTTP ping target must be 1024 16-bit Unicode characters or less.

    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. The protocol is either TCP, HTTP, HTTPS, or SSL. The range of valid ports is one (1) through 65535.

    TCP is the default, specified as a TCP: port pair, for example "TCP:5000". In this case, a health check simply attempts to open a TCP connection to the instance on the specified port. Failure to connect within the configured timeout is considered unhealthy.

    SSL is also specified as SSL: port pair, for example, SSL:5000.

    For HTTP/HTTPS, you must include a ping path in the string. HTTP is specified as a HTTP:port;/;PathToPing; grouping, for example "HTTP:80/weather/us/wa/seattle". In this case, a HTTP GET request is issued to the instance on the given port and path. Any answer other than "200 OK" within the timeout period is considered unhealthy.

    The total length of the HTTP ping target must be 1024 16-bit Unicode characters or less.

    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

    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.
    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

    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.
    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

    Attributes List<object>
    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 []interface{}
    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.
    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 any[]
    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[Any]
    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<Any>
    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.

    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.62.0
    published on Monday, Apr 20, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws-native
      Try Pulumi Cloud free. Your team will thank you.