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.69.0
published on Monday, Jun 15, 2026 by Pulumi
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

    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(load_balancer_name: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetLoadBalancerResult
    def get_load_balancer_output(load_balancer_name: pulumi.Input[Optional[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
    data "aws-native_elasticloadbalancing_getloadbalancer" "name" {
        # arguments
    }

    The following arguments are supported:

    LoadBalancerName string
    The name of the load balancer. This name must be unique within your set of load balancers for the region.
    LoadBalancerName string
    The name of the load balancer. This name must be unique within your set of load balancers for the region.
    load_balancer_name string
    The name of the load balancer. This name must be unique within your set of load balancers for the region.
    loadBalancerName String
    The name of the load balancer. This name must be unique within your set of load balancers for the region.
    loadBalancerName string
    The name of the load balancer. This name must be unique within your set of load balancers for the region.
    load_balancer_name str
    The name of the load balancer. This name must be unique within your set of load balancers for the region.
    loadBalancerName String
    The name of the load balancer. This name must be unique within your set of load balancers for the region.

    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.
    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.
    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.
    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.
    CrossZone bool
    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.
    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.
    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.
    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.
    SourceSecurityGroup Pulumi.AwsNative.ElasticLoadBalancing.Outputs.LoadBalancerSourceSecurityGroup
    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.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.
    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.
    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 bool
    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.
    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.
    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.
    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.
    SourceSecurityGroup LoadBalancerSourceSecurityGroup
    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.
    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.
    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.
    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.
    dns_name string
    The DNS name for the load balancer
    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.
    listeners list(object)
    The Listeners for the load balancer. You can specify at most one listener per port.
    policies list(object)
    The policies defined for your Classic Load Balancer. Specify only back-end server policies.
    security_groups list(string)
    The security groups for the load balancer. Valid only for load balancers in a VPC.
    source_security_group object
    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.
    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.
    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.
    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.
    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.
    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.
    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.
    sourceSecurityGroup LoadBalancerSourceSecurityGroup
    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.
    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.
    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.
    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.
    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.
    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.
    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.
    sourceSecurityGroup LoadBalancerSourceSecurityGroup
    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.
    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.
    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.
    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.
    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.
    cross_zone bool
    If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.
    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.
    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.
    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 LoadBalancerSourceSecurityGroup
    subnets Sequence[str]
    The IDs of the subnets for the load balancer. You can specify at most one subnet per 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.
    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.
    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.
    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.
    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.
    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.
    sourceSecurityGroup Property Map
    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.

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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial