This is the new *CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::ElasticLoadBalancing::LoadBalancer
<a name="aws-resource-elasticloadbalancing-loadbalancer"></a>

Specifies a Classic Load Balancer.

If this resource has a public IP address and is also in a VPC that is defined in the same template, you must use the [DependsOn attribute](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-dependson.html) to declare a dependency on the VPC-gateway attachment.

## Syntax
<a name="aws-resource-elasticloadbalancing-loadbalancer-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-resource-elasticloadbalancing-loadbalancer-syntax.json"></a>

```
{
  "Type" : "AWS::ElasticLoadBalancing::LoadBalancer",
  "Properties" : {
      "[AccessLoggingPolicy](#cfn-elasticloadbalancing-loadbalancer-accessloggingpolicy)" : AccessLoggingPolicy,
      "[AppCookieStickinessPolicy](#cfn-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy)" : [ AppCookieStickinessPolicy, ... ],
      "[AvailabilityZones](#cfn-elasticloadbalancing-loadbalancer-availabilityzones)" : [ String, ... ],
      "[ConnectionDrainingPolicy](#cfn-elasticloadbalancing-loadbalancer-connectiondrainingpolicy)" : ConnectionDrainingPolicy,
      "[ConnectionSettings](#cfn-elasticloadbalancing-loadbalancer-connectionsettings)" : ConnectionSettings,
      "[CrossZone](#cfn-elasticloadbalancing-loadbalancer-crosszone)" : Boolean,
      "[HealthCheck](#cfn-elasticloadbalancing-loadbalancer-healthcheck)" : HealthCheck,
      "[Instances](#cfn-elasticloadbalancing-loadbalancer-instances)" : [ String, ... ],
      "[LBCookieStickinessPolicy](#cfn-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy)" : [ LBCookieStickinessPolicy, ... ],
      "[Listeners](#cfn-elasticloadbalancing-loadbalancer-listeners)" : [ Listeners, ... ],
      "[LoadBalancerName](#cfn-elasticloadbalancing-loadbalancer-loadbalancername)" : String,
      "[Policies](#cfn-elasticloadbalancing-loadbalancer-policies)" : [ Policies, ... ],
      "[Scheme](#cfn-elasticloadbalancing-loadbalancer-scheme)" : String,
      "[SecurityGroups](#cfn-elasticloadbalancing-loadbalancer-securitygroups)" : [ String, ... ],
      "[Subnets](#cfn-elasticloadbalancing-loadbalancer-subnets)" : [ String, ... ],
      "[Tags](#cfn-elasticloadbalancing-loadbalancer-tags)" : [ Tag, ... ]
    }
}
```

### YAML
<a name="aws-resource-elasticloadbalancing-loadbalancer-syntax.yaml"></a>

```
Type: AWS::ElasticLoadBalancing::LoadBalancer
Properties:
  [AccessLoggingPolicy](#cfn-elasticloadbalancing-loadbalancer-accessloggingpolicy): 
    AccessLoggingPolicy
  [AppCookieStickinessPolicy](#cfn-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy): 
    - AppCookieStickinessPolicy
  [AvailabilityZones](#cfn-elasticloadbalancing-loadbalancer-availabilityzones): 
    - String
  [ConnectionDrainingPolicy](#cfn-elasticloadbalancing-loadbalancer-connectiondrainingpolicy): 
    ConnectionDrainingPolicy
  [ConnectionSettings](#cfn-elasticloadbalancing-loadbalancer-connectionsettings): 
    ConnectionSettings
  [CrossZone](#cfn-elasticloadbalancing-loadbalancer-crosszone): Boolean
  [HealthCheck](#cfn-elasticloadbalancing-loadbalancer-healthcheck): 
    HealthCheck
  [Instances](#cfn-elasticloadbalancing-loadbalancer-instances): 
    - String
  [LBCookieStickinessPolicy](#cfn-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy): 
    - LBCookieStickinessPolicy
  [Listeners](#cfn-elasticloadbalancing-loadbalancer-listeners): 
    - Listeners
  [LoadBalancerName](#cfn-elasticloadbalancing-loadbalancer-loadbalancername): String
  [Policies](#cfn-elasticloadbalancing-loadbalancer-policies): 
    - Policies
  [Scheme](#cfn-elasticloadbalancing-loadbalancer-scheme): String
  [SecurityGroups](#cfn-elasticloadbalancing-loadbalancer-securitygroups): 
    - String
  [Subnets](#cfn-elasticloadbalancing-loadbalancer-subnets): 
    - String
  [Tags](#cfn-elasticloadbalancing-loadbalancer-tags): 
    - Tag
```

## Properties
<a name="aws-resource-elasticloadbalancing-loadbalancer-properties"></a>

`AccessLoggingPolicy`  <a name="cfn-elasticloadbalancing-loadbalancer-accessloggingpolicy"></a>
Information about where and how access logs are stored for the load balancer.  
*Required*: No  
*Type*: [AccessLoggingPolicy](aws-properties-elasticloadbalancing-loadbalancer-accessloggingpolicy.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`AppCookieStickinessPolicy`  <a name="cfn-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy"></a>
Information about a policy for application-controlled session stickiness.  
*Required*: No  
*Type*: [Array](aws-properties-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy.md) of [AppCookieStickinessPolicy](aws-properties-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`AvailabilityZones`  <a name="cfn-elasticloadbalancing-loadbalancer-availabilityzones"></a>
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.  
*Required*: No  
*Type*: Array of String  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`ConnectionDrainingPolicy`  <a name="cfn-elasticloadbalancing-loadbalancer-connectiondrainingpolicy"></a>
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](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-conn-drain.html) in the *User Guide for Classic Load Balancers*.  
*Required*: No  
*Type*: [ConnectionDrainingPolicy](aws-properties-elasticloadbalancing-loadbalancer-connectiondrainingpolicy.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ConnectionSettings`  <a name="cfn-elasticloadbalancing-loadbalancer-connectionsettings"></a>
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](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-idle-timeout.html) in the *User Guide for Classic Load Balancers*.  
*Required*: No  
*Type*: [ConnectionSettings](aws-properties-elasticloadbalancing-loadbalancer-connectionsettings.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`CrossZone`  <a name="cfn-elasticloadbalancing-loadbalancer-crosszone"></a>
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](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-crosszone-lb.html) in the *User Guide for Classic Load Balancers*.  
*Required*: No  
*Type*: Boolean  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`HealthCheck`  <a name="cfn-elasticloadbalancing-loadbalancer-healthcheck"></a>
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.  
*Required*: No  
*Type*: [HealthCheck](aws-properties-elasticloadbalancing-loadbalancer-healthcheck.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Instances`  <a name="cfn-elasticloadbalancing-loadbalancer-instances"></a>
The IDs of the instances for the load balancer.  
*Required*: No  
*Type*: Array of String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`LBCookieStickinessPolicy`  <a name="cfn-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy"></a>
Information about a policy for duration-based session stickiness.  
*Required*: No  
*Type*: [Array](aws-properties-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy.md) of [LBCookieStickinessPolicy](aws-properties-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Listeners`  <a name="cfn-elasticloadbalancing-loadbalancer-listeners"></a>
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.  
*Required*: Yes  
*Type*: [Array](aws-properties-elasticloadbalancing-loadbalancer-listeners.md) of [Listeners](aws-properties-elasticloadbalancing-loadbalancer-listeners.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`LoadBalancerName`  <a name="cfn-elasticloadbalancing-loadbalancer-loadbalancername"></a>
The name of the load balancer. This name must be unique within your set of load balancers for the region.  
If you don't specify a name, AWS CloudFormation generates a unique physical ID for the load balancer. For more information, see [Name Type](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html). If you specify a name, you cannot perform updates that require replacement of this resource, but you can perform other updates. To replace the resource, specify a new name.   
*Required*: No  
*Type*: String  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Policies`  <a name="cfn-elasticloadbalancing-loadbalancer-policies"></a>
The policies defined for your Classic Load Balancer. Specify only back-end server policies.  
*Required*: No  
*Type*: [Array](aws-properties-elasticloadbalancing-loadbalancer-policies.md) of [Policies](aws-properties-elasticloadbalancing-loadbalancer-policies.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Scheme`  <a name="cfn-elasticloadbalancing-loadbalancer-scheme"></a>
The type of load balancer. Valid only for load balancers in a VPC.  
If `Scheme` is `internet-facing`, the load balancer has a public DNS name that resolves to a public IP address.  
If `Scheme` is `internal`, the load balancer has a public DNS name that resolves to a private IP address.  
*Required*: No  
*Type*: String  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`SecurityGroups`  <a name="cfn-elasticloadbalancing-loadbalancer-securitygroups"></a>
The security groups for the load balancer. Valid only for load balancers in a VPC.  
*Required*: No  
*Type*: Array of String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Subnets`  <a name="cfn-elasticloadbalancing-loadbalancer-subnets"></a>
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.  
*Required*: No  
*Type*: Array of String  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`Tags`  <a name="cfn-elasticloadbalancing-loadbalancer-tags"></a>
The tags associated with a load balancer.  
*Required*: No  
*Type*: Array of [Tag](aws-properties-elasticloadbalancing-loadbalancer-tag.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## Return values
<a name="aws-resource-elasticloadbalancing-loadbalancer-return-values"></a>

### Ref
<a name="aws-resource-elasticloadbalancing-loadbalancer-return-values-ref"></a>

When you pass the logical ID of this resource to the intrinsic `Ref` function, `Ref` returns the name of the load balancer.

For more information about using the `Ref` function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html).

### Fn::GetAtt
<a name="aws-resource-elasticloadbalancing-loadbalancer-return-values-fn--getatt"></a>

The `Fn::GetAtt` intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the `Fn::GetAtt` intrinsic function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html).

#### 
<a name="aws-resource-elasticloadbalancing-loadbalancer-return-values-fn--getatt-fn--getatt"></a>

`CanonicalHostedZoneName`  <a name="CanonicalHostedZoneName-fn::getatt"></a>
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`  <a name="CanonicalHostedZoneNameID-fn::getatt"></a>
The ID of the Route 53 hosted zone name that is associated with the load balancer.

`DNSName`  <a name="DNSName-fn::getatt"></a>
The DNS name for the load balancer.

`SourceSecurityGroup.GroupName`  <a name="SourceSecurityGroup.GroupName-fn::getatt"></a>
The name of the security group that you can use as part of your inbound rules for your load balancer's back-end instances.

`SourceSecurityGroup.OwnerAlias`  <a name="SourceSecurityGroup.OwnerAlias-fn::getatt"></a>
The owner of the source security group.

## Examples
<a name="aws-resource-elasticloadbalancing-loadbalancer--examples"></a>

**Topics**
+ [Classic Load Balancer in a default VPC](#aws-resource-elasticloadbalancing-loadbalancer--examples--Classic_Load_Balancer_in_a_default_VPC)
+ [Classic Load Balancer in a nondefault VPC](#aws-resource-elasticloadbalancing-loadbalancer--examples--Classic_Load_Balancer_in_a_nondefault_VPC)

### Classic Load Balancer in a default VPC
<a name="aws-resource-elasticloadbalancing-loadbalancer--examples--Classic_Load_Balancer_in_a_default_VPC"></a>

The following example specifies a Classic Load Balancer with a secure listener in a default VPC.

#### JSON
<a name="aws-resource-elasticloadbalancing-loadbalancer--examples--Classic_Load_Balancer_in_a_default_VPC--json"></a>

```
"MyLoadBalancer" : {
    "Type": "AWS::ElasticLoadBalancing::LoadBalancer",
    "Properties": {
        "AvailabilityZones": [ "us-east-2a" ],
        "CrossZone": "true",
        "Listeners": [{
            "InstancePort": "80",
            "InstanceProtocol": "HTTP",
            "LoadBalancerPort": "443",
            "Protocol": "HTTPS",
            "PolicyNames": [ "My-SSLNegotiation-Policy" ],
            "SSLCertificateId": "arn:aws:iam::123456789012:server-certificate/my-server-certificate"
        }],
        "HealthCheck": {
            "Target": "HTTP:80/",
            "HealthyThreshold": "2",
            "UnhealthyThreshold": "3",
            "Interval": "10",
            "Timeout": "5"
        },
        "Policies": [{
            "PolicyName": "My-SSLNegotiation-Policy",
            "PolicyType": "SSLNegotiationPolicyType",
            "Attributes": [{
                "Name": "Reference-Security-Policy",
                "Value": "ELBSecurityPolicy-TLS-1-2-2017-01"
            }]
        }]
    }
}
```

#### YAML
<a name="aws-resource-elasticloadbalancing-loadbalancer--examples--Classic_Load_Balancer_in_a_default_VPC--yaml"></a>

```
MyLoadBalancer:
    Type: AWS::ElasticLoadBalancing::LoadBalancer
    Properties:
      AvailabilityZones:
      - "us-east-2a"
      CrossZone: true
      Listeners:
      - InstancePort: '80'
        InstanceProtocol: HTTP
        LoadBalancerPort: '443'
        Protocol: HTTPS
        PolicyNames: 
        - My-SSLNegotiation-Policy
        SSLCertificateId: arn:aws:iam::123456789012:server-certificate/my-server-certificate
      HealthCheck:
        Target: HTTP:80/
        HealthyThreshold: '2'
        UnhealthyThreshold: '3'
        Interval: '10'
        Timeout: '5'
      Policies:
      - PolicyName: My-SSLNegotiation-Policy
        PolicyType: SSLNegotiationPolicyType
        Attributes:
        - Name: Reference-Security-Policy
          Value: ELBSecurityPolicy-TLS-1-2-2017-01
```

### Classic Load Balancer in a nondefault VPC
<a name="aws-resource-elasticloadbalancing-loadbalancer--examples--Classic_Load_Balancer_in_a_nondefault_VPC"></a>

The following example specifies a Classic Load Balancer with an HTTP listener and a VPC with one subnet and an internet gateway.

#### JSON
<a name="aws-resource-elasticloadbalancing-loadbalancer--examples--Classic_Load_Balancer_in_a_nondefault_VPC--json"></a>

```
{
    "Resources": {
        "myLoadBalancer": {
            "Type": "AWS::ElasticLoadBalancing::LoadBalancer",
            "Properties": {
                "Subnets": [
                    {
                        "Ref": "mySubnet"
                    }
                ],
                "Listeners": [
                    {
                        "LoadBalancerPort": "80",
                        "InstancePort": "80",
                        "Protocol": "HTTP"
                    }
                ]
            }
        },
        "myVPC": {
            "Type": "AWS::EC2::VPC",
            "Properties": {
                "CidrBlock": "10.0.0.0/16",
                "EnableDnsSupport": true,
                "EnableDnsHostnames": true
            }
        },
        "mySubnet": {
            "Type": "AWS::EC2::Subnet",
            "Properties": {
                "VpcId": {
                    "Ref": "myVPC"
                },
                "CidrBlock": "10.0.0.0/24",
                "AvailabilityZone": {
                    "Fn::Select": [
                        1,
                        {
                            "Fn::GetAZs": ""
                        }
                    ]
                }
            }
        },
        "myInternetGateway": {
            "Type": "AWS::EC2::InternetGateway"
        },
        "myGatewayAttachment": {
            "Type": "AWS::EC2::VPCGatewayAttachment",
            "Properties": {
                "VpcId": {
                    "Ref": "myVPC"
                },
                "InternetGatewayId": {
                    "Ref": "myInternetGateway"
                }
            }
        },
        "myRouteTable": {
            "Type": "AWS::EC2::RouteTable",
            "Properties": {
                "VpcId": {
                    "Ref": "myVPC"
                }
            }
        },
        "myRoute": {
            "Type": "AWS::EC2::Route",
            "Properties": {
                "DestinationCidrBlock": "0.0.0.0/0",
                "GatewayId": {
                    "Ref": "myInternetGateway"
                },
                "RouteTableId": {
                    "Ref": "myRouteTable"
                }
            }
        },
        "myRouteTableAssociation": {
            "Type": "AWS::EC2::SubnetRouteTableAssociation",
            "Properties": {
                "RouteTableId": {
                    "Ref": "myRouteTable"
                },
                "SubnetId": {
                    "Ref": "mySubnet"
                }
            }
        }
    }
}
```

#### YAML
<a name="aws-resource-elasticloadbalancing-loadbalancer--examples--Classic_Load_Balancer_in_a_nondefault_VPC--yaml"></a>

```
Resources:
  myLoadBalancer:
    Type: AWS::ElasticLoadBalancing::LoadBalancer
    Properties:
      Subnets:
      - !Ref mySubnet
      Listeners:
      - LoadBalancerPort: '80'
        InstancePort: '80'
        Protocol: HTTP
  myVPC:
    Type: AWS::EC2::VPC
    Properties:
      CidrBlock: 10.0.0.0/16
      EnableDnsSupport: true
      EnableDnsHostnames: true
  mySubnet:
    Type: AWS::EC2::Subnet
    Properties:
      VpcId: !Ref myVPC
      CidrBlock: 10.0.0.0/24
      AvailabilityZone: !Select [ 1, !GetAZs ]
  myInternetGateway:
    Type: AWS::EC2::InternetGateway
  myGatewayAttachment:
    Type: AWS::EC2::VPCGatewayAttachment
    Properties:
      VpcId: !Ref myVPC
      InternetGatewayId: !Ref myInternetGateway
  myRouteTable:
    Type: AWS::EC2::RouteTable
    Properties:
      VpcId: !Ref myVPC
  myRoute:
    Type: AWS::EC2::Route
    Properties:
      DestinationCidrBlock: 0.0.0.0/0
      GatewayId: !Ref myInternetGateway
      RouteTableId: !Ref myRouteTable
  myRouteTableAssociation:
    Type: AWS::EC2::SubnetRouteTableAssociation
    Properties:
      RouteTableId: !Ref myRouteTable
      SubnetId: !Ref mySubnet
```

## See also
<a name="aws-resource-elasticloadbalancing-loadbalancer--seealso"></a>
+  [Elastic Load Balancing Template Snippets](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/quickref-elb.html) 
+ [CreateLoadBalancer](https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_CreateLoadBalancer.html) in the *Elastic Load Balancing API Reference (version 2012-06-01)*
+ [ModifyLoadBalancerAttributes](https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_ModifyLoadBalancerAttributes.html) in the *Elastic Load Balancing API Reference (version 2012-06-01)*
+ [ConfigureHealthCheck](https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_ConfigureHealthCheck.html) in the *Elastic Load Balancing API Reference (version 2012-06-01)*
+  [User Guide for Classic Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic) 



# AWS::ElasticLoadBalancing::LoadBalancer AccessLoggingPolicy
<a name="aws-properties-elasticloadbalancing-loadbalancer-accessloggingpolicy"></a>

Specifies where and how access logs are stored for your Classic Load Balancer.

## Syntax
<a name="aws-properties-elasticloadbalancing-loadbalancer-accessloggingpolicy-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-elasticloadbalancing-loadbalancer-accessloggingpolicy-syntax.json"></a>

```
{
  "[EmitInterval](#cfn-elasticloadbalancing-loadbalancer-accessloggingpolicy-emitinterval)" : Integer,
  "[Enabled](#cfn-elasticloadbalancing-loadbalancer-accessloggingpolicy-enabled)" : Boolean,
  "[S3BucketName](#cfn-elasticloadbalancing-loadbalancer-accessloggingpolicy-s3bucketname)" : String,
  "[S3BucketPrefix](#cfn-elasticloadbalancing-loadbalancer-accessloggingpolicy-s3bucketprefix)" : String
}
```

### YAML
<a name="aws-properties-elasticloadbalancing-loadbalancer-accessloggingpolicy-syntax.yaml"></a>

```
  [EmitInterval](#cfn-elasticloadbalancing-loadbalancer-accessloggingpolicy-emitinterval): Integer
  [Enabled](#cfn-elasticloadbalancing-loadbalancer-accessloggingpolicy-enabled): Boolean
  [S3BucketName](#cfn-elasticloadbalancing-loadbalancer-accessloggingpolicy-s3bucketname): String
  [S3BucketPrefix](#cfn-elasticloadbalancing-loadbalancer-accessloggingpolicy-s3bucketprefix): String
```

## Properties
<a name="aws-properties-elasticloadbalancing-loadbalancer-accessloggingpolicy-properties"></a>

`EmitInterval`  <a name="cfn-elasticloadbalancing-loadbalancer-accessloggingpolicy-emitinterval"></a>
The interval for publishing the access logs. You can specify an interval of either 5 minutes or 60 minutes.  
Default: 60 minutes  
*Required*: No  
*Type*: Integer  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Enabled`  <a name="cfn-elasticloadbalancing-loadbalancer-accessloggingpolicy-enabled"></a>
Specifies whether access logs are enabled for the load balancer.  
*Required*: Yes  
*Type*: Boolean  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`S3BucketName`  <a name="cfn-elasticloadbalancing-loadbalancer-accessloggingpolicy-s3bucketname"></a>
The name of the Amazon S3 bucket where the access logs are stored.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`S3BucketPrefix`  <a name="cfn-elasticloadbalancing-loadbalancer-accessloggingpolicy-s3bucketprefix"></a>
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.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## See also
<a name="aws-properties-elasticloadbalancing-loadbalancer-accessloggingpolicy--seealso"></a>
+ [ModifyLoadBalancerAttributes](https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_ModifyLoadBalancerAttributes.html) in the *Elastic Load Balancing API Reference (version 2012-06-01)*
+ [Access Logs](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/access-log-collection.html) in the *User Guide for Classic Load Balancers*



# AWS::ElasticLoadBalancing::LoadBalancer AppCookieStickinessPolicy
<a name="aws-properties-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy"></a>

Specifies a policy for application-controlled session stickiness for your Classic Load Balancer.

To associate a policy with a listener, use the [PolicyNames](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-listener.html#cfn-ec2-elb-listener-policynames) property for the listener.

## Syntax
<a name="aws-properties-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy-syntax.json"></a>

```
{
  "[CookieName](#cfn-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy-cookiename)" : String,
  "[PolicyName](#cfn-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy-policyname)" : String
}
```

### YAML
<a name="aws-properties-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy-syntax.yaml"></a>

```
  [CookieName](#cfn-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy-cookiename): String
  [PolicyName](#cfn-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy-policyname): String
```

## Properties
<a name="aws-properties-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy-properties"></a>

`CookieName`  <a name="cfn-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy-cookiename"></a>
The name of the application cookie used for stickiness.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`PolicyName`  <a name="cfn-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy-policyname"></a>
The mnemonic name for the policy being created. The name must be unique within a set of policies for this load balancer.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## See also
<a name="aws-properties-elasticloadbalancing-loadbalancer-appcookiestickinesspolicy--seealso"></a>
+ [CreateAppCookieStickinessPolicy](https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_CreateAppCookieStickinessPolicy.html) in the *Elastic Load Balancing API Reference (version 2012-06-01)*
+ [Sticky Sessions](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-sticky-sessions.html) in the *User Guide for Classic Load Balancers*



# AWS::ElasticLoadBalancing::LoadBalancer ConnectionDrainingPolicy
<a name="aws-properties-elasticloadbalancing-loadbalancer-connectiondrainingpolicy"></a>

Specifies the connection draining settings for your Classic Load Balancer.

## Syntax
<a name="aws-properties-elasticloadbalancing-loadbalancer-connectiondrainingpolicy-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-elasticloadbalancing-loadbalancer-connectiondrainingpolicy-syntax.json"></a>

```
{
  "[Enabled](#cfn-elasticloadbalancing-loadbalancer-connectiondrainingpolicy-enabled)" : Boolean,
  "[Timeout](#cfn-elasticloadbalancing-loadbalancer-connectiondrainingpolicy-timeout)" : Integer
}
```

### YAML
<a name="aws-properties-elasticloadbalancing-loadbalancer-connectiondrainingpolicy-syntax.yaml"></a>

```
  [Enabled](#cfn-elasticloadbalancing-loadbalancer-connectiondrainingpolicy-enabled): Boolean
  [Timeout](#cfn-elasticloadbalancing-loadbalancer-connectiondrainingpolicy-timeout): Integer
```

## Properties
<a name="aws-properties-elasticloadbalancing-loadbalancer-connectiondrainingpolicy-properties"></a>

`Enabled`  <a name="cfn-elasticloadbalancing-loadbalancer-connectiondrainingpolicy-enabled"></a>
Specifies whether connection draining is enabled for the load balancer.  
*Required*: Yes  
*Type*: Boolean  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Timeout`  <a name="cfn-elasticloadbalancing-loadbalancer-connectiondrainingpolicy-timeout"></a>
The maximum time, in seconds, to keep the existing connections open before deregistering the instances.  
*Required*: No  
*Type*: Integer  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## See also
<a name="aws-properties-elasticloadbalancing-loadbalancer-connectiondrainingpolicy--seealso"></a>
+ [ModifyLoadBalancerAttributes](https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_ModifyLoadBalancerAttributes.html) in the *Elastic Load Balancing API Reference (version 2012-06-01)*
+ [Connection Draining](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-conn-drain.html) in the *User Guide for Classic Load Balancers*



# AWS::ElasticLoadBalancing::LoadBalancer ConnectionSettings
<a name="aws-properties-elasticloadbalancing-loadbalancer-connectionsettings"></a>

Specifies the idle timeout value for your Classic Load Balancer.

## Syntax
<a name="aws-properties-elasticloadbalancing-loadbalancer-connectionsettings-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-elasticloadbalancing-loadbalancer-connectionsettings-syntax.json"></a>

```
{
  "[IdleTimeout](#cfn-elasticloadbalancing-loadbalancer-connectionsettings-idletimeout)" : Integer
}
```

### YAML
<a name="aws-properties-elasticloadbalancing-loadbalancer-connectionsettings-syntax.yaml"></a>

```
  [IdleTimeout](#cfn-elasticloadbalancing-loadbalancer-connectionsettings-idletimeout): Integer
```

## Properties
<a name="aws-properties-elasticloadbalancing-loadbalancer-connectionsettings-properties"></a>

`IdleTimeout`  <a name="cfn-elasticloadbalancing-loadbalancer-connectionsettings-idletimeout"></a>
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.  
*Required*: Yes  
*Type*: Integer  
*Minimum*: `1`  
*Maximum*: `3600`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## See also
<a name="aws-properties-elasticloadbalancing-loadbalancer-connectionsettings--seealso"></a>
+ [ModifyLoadBalancerAttributes](https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_ModifyLoadBalancerAttributes.html) in the *Elastic Load Balancing API Reference (version 2012-06-01)*
+ [Idle Connection Timeout](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-idle-timeout.html) in the *User Guide for Classic Load Balancers*



# AWS::ElasticLoadBalancing::LoadBalancer HealthCheck
<a name="aws-properties-elasticloadbalancing-loadbalancer-healthcheck"></a>

Specifies health check settings for your Classic Load Balancer.

## Syntax
<a name="aws-properties-elasticloadbalancing-loadbalancer-healthcheck-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-elasticloadbalancing-loadbalancer-healthcheck-syntax.json"></a>

```
{
  "[HealthyThreshold](#cfn-elasticloadbalancing-loadbalancer-healthcheck-healthythreshold)" : String,
  "[Interval](#cfn-elasticloadbalancing-loadbalancer-healthcheck-interval)" : String,
  "[Target](#cfn-elasticloadbalancing-loadbalancer-healthcheck-target)" : String,
  "[Timeout](#cfn-elasticloadbalancing-loadbalancer-healthcheck-timeout)" : String,
  "[UnhealthyThreshold](#cfn-elasticloadbalancing-loadbalancer-healthcheck-unhealthythreshold)" : String
}
```

### YAML
<a name="aws-properties-elasticloadbalancing-loadbalancer-healthcheck-syntax.yaml"></a>

```
  [HealthyThreshold](#cfn-elasticloadbalancing-loadbalancer-healthcheck-healthythreshold): String
  [Interval](#cfn-elasticloadbalancing-loadbalancer-healthcheck-interval): String
  [Target](#cfn-elasticloadbalancing-loadbalancer-healthcheck-target): String
  [Timeout](#cfn-elasticloadbalancing-loadbalancer-healthcheck-timeout): String
  [UnhealthyThreshold](#cfn-elasticloadbalancing-loadbalancer-healthcheck-unhealthythreshold): String
```

## Properties
<a name="aws-properties-elasticloadbalancing-loadbalancer-healthcheck-properties"></a>

`HealthyThreshold`  <a name="cfn-elasticloadbalancing-loadbalancer-healthcheck-healthythreshold"></a>
The number of consecutive health checks successes required before moving the instance to the `Healthy` state.  
*Required*: Yes  
*Type*: String  
*Minimum*: `2`  
*Maximum*: `10`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Interval`  <a name="cfn-elasticloadbalancing-loadbalancer-healthcheck-interval"></a>
The approximate interval, in seconds, between health checks of an individual instance.  
*Required*: Yes  
*Type*: String  
*Minimum*: `5`  
*Maximum*: `300`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Target`  <a name="cfn-elasticloadbalancing-loadbalancer-healthcheck-target"></a>
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.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Timeout`  <a name="cfn-elasticloadbalancing-loadbalancer-healthcheck-timeout"></a>
The amount of time, in seconds, during which no response means a failed health check.  
This value must be less than the `Interval` value.  
*Required*: Yes  
*Type*: String  
*Minimum*: `2`  
*Maximum*: `60`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`UnhealthyThreshold`  <a name="cfn-elasticloadbalancing-loadbalancer-healthcheck-unhealthythreshold"></a>
The number of consecutive health check failures required before moving the instance to the `Unhealthy` state.  
*Required*: Yes  
*Type*: String  
*Minimum*: `2`  
*Maximum*: `10`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## See also
<a name="aws-properties-elasticloadbalancing-loadbalancer-healthcheck--seealso"></a>
+ [ConfigureHealthCheck](https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_ConfigureHealthCheck.html) in the *Elastic Load Balancing API Reference (version 2012-06-01)*
+ [Configure Health Checks](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-healthchecks.html) in the *User Guide for Classic Load Balancers*



# AWS::ElasticLoadBalancing::LoadBalancer LBCookieStickinessPolicy
<a name="aws-properties-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy"></a>

Specifies a policy for duration-based session stickiness for your Classic Load Balancer.

To associate a policy with a listener, use the [PolicyNames](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-listener.html#cfn-ec2-elb-listener-policynames) property for the listener.

## Syntax
<a name="aws-properties-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy-syntax.json"></a>

```
{
  "[CookieExpirationPeriod](#cfn-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy-cookieexpirationperiod)" : String,
  "[PolicyName](#cfn-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy-policyname)" : String
}
```

### YAML
<a name="aws-properties-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy-syntax.yaml"></a>

```
  [CookieExpirationPeriod](#cfn-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy-cookieexpirationperiod): String
  [PolicyName](#cfn-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy-policyname): String
```

## Properties
<a name="aws-properties-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy-properties"></a>

`CookieExpirationPeriod`  <a name="cfn-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy-cookieexpirationperiod"></a>
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.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`PolicyName`  <a name="cfn-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy-policyname"></a>
The name of the policy. This name must be unique within the set of policies for this load balancer.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## See also
<a name="aws-properties-elasticloadbalancing-loadbalancer-lbcookiestickinesspolicy--seealso"></a>
+ [CreateLBCookieStickinessPolicy](https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_CreateLBCookieStickinessPolicy.html) in the *Elastic Load Balancing API Reference (version 2012-06-01)*
+ [Sticky Sessions](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-sticky-sessions.html) in the *User Guide for Classic Load Balancers*



# AWS::ElasticLoadBalancing::LoadBalancer Listeners
<a name="aws-properties-elasticloadbalancing-loadbalancer-listeners"></a>

Specifies a listener for your Classic Load Balancer.

Modifying any property replaces the listener.

## Syntax
<a name="aws-properties-elasticloadbalancing-loadbalancer-listeners-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-elasticloadbalancing-loadbalancer-listeners-syntax.json"></a>

```
{
  "[InstancePort](#cfn-elasticloadbalancing-loadbalancer-listeners-instanceport)" : String,
  "[InstanceProtocol](#cfn-elasticloadbalancing-loadbalancer-listeners-instanceprotocol)" : String,
  "[LoadBalancerPort](#cfn-elasticloadbalancing-loadbalancer-listeners-loadbalancerport)" : String,
  "[PolicyNames](#cfn-elasticloadbalancing-loadbalancer-listeners-policynames)" : [ String, ... ],
  "[Protocol](#cfn-elasticloadbalancing-loadbalancer-listeners-protocol)" : String,
  "[SSLCertificateId](#cfn-elasticloadbalancing-loadbalancer-listeners-sslcertificateid)" : String
}
```

### YAML
<a name="aws-properties-elasticloadbalancing-loadbalancer-listeners-syntax.yaml"></a>

```
  [InstancePort](#cfn-elasticloadbalancing-loadbalancer-listeners-instanceport): String
  [InstanceProtocol](#cfn-elasticloadbalancing-loadbalancer-listeners-instanceprotocol): String
  [LoadBalancerPort](#cfn-elasticloadbalancing-loadbalancer-listeners-loadbalancerport): String
  [PolicyNames](#cfn-elasticloadbalancing-loadbalancer-listeners-policynames): 
    - String
  [Protocol](#cfn-elasticloadbalancing-loadbalancer-listeners-protocol): String
  [SSLCertificateId](#cfn-elasticloadbalancing-loadbalancer-listeners-sslcertificateid): String
```

## Properties
<a name="aws-properties-elasticloadbalancing-loadbalancer-listeners-properties"></a>

`InstancePort`  <a name="cfn-elasticloadbalancing-loadbalancer-listeners-instanceport"></a>
The port on which the instance is listening.  
*Required*: Yes  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `65535`  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`InstanceProtocol`  <a name="cfn-elasticloadbalancing-loadbalancer-listeners-instanceprotocol"></a>
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.  
*Required*: No  
*Type*: String  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`LoadBalancerPort`  <a name="cfn-elasticloadbalancing-loadbalancer-listeners-loadbalancerport"></a>
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.  
*Required*: Yes  
*Type*: String  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`PolicyNames`  <a name="cfn-elasticloadbalancing-loadbalancer-listeners-policynames"></a>
The names of the policies to associate with the listener.  
*Required*: No  
*Type*: Array of String  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`Protocol`  <a name="cfn-elasticloadbalancing-loadbalancer-listeners-protocol"></a>
The load balancer transport protocol to use for routing: HTTP, HTTPS, TCP, or SSL.  
*Required*: Yes  
*Type*: String  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`SSLCertificateId`  <a name="cfn-elasticloadbalancing-loadbalancer-listeners-sslcertificateid"></a>
The Amazon Resource Name (ARN) of the server certificate.  
*Required*: No  
*Type*: String  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

## See also
<a name="aws-properties-elasticloadbalancing-loadbalancer-listeners--seealso"></a>
+ [CreateLoadBalancerListeners](https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_CreateLoadBalancerListeners.html) in the *Elastic Load Balancing API Reference (version 2012-06-01)*
+ [Listeners](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-listener-config.html) in the *User Guide for Classic Load Balancers*
+ [HTTPS Listeners](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-https-load-balancers.html) in the *User Guide for Classic Load Balancers*



# AWS::ElasticLoadBalancing::LoadBalancer Policies
<a name="aws-properties-elasticloadbalancing-loadbalancer-policies"></a>

Specifies policies for your Classic Load Balancer.

To associate policies with a listener, use the [PolicyNames](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-listener.html#cfn-ec2-elb-listener-policynames) property for the listener.

## Syntax
<a name="aws-properties-elasticloadbalancing-loadbalancer-policies-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-elasticloadbalancing-loadbalancer-policies-syntax.json"></a>

```
{
  "[Attributes](#cfn-elasticloadbalancing-loadbalancer-policies-attributes)" : [ {Key: Value, ...}, ... ],
  "[InstancePorts](#cfn-elasticloadbalancing-loadbalancer-policies-instanceports)" : [ String, ... ],
  "[LoadBalancerPorts](#cfn-elasticloadbalancing-loadbalancer-policies-loadbalancerports)" : [ String, ... ],
  "[PolicyName](#cfn-elasticloadbalancing-loadbalancer-policies-policyname)" : String,
  "[PolicyType](#cfn-elasticloadbalancing-loadbalancer-policies-policytype)" : String
}
```

### YAML
<a name="aws-properties-elasticloadbalancing-loadbalancer-policies-syntax.yaml"></a>

```
  [Attributes](#cfn-elasticloadbalancing-loadbalancer-policies-attributes): 
    - 
    Key: Value
  [InstancePorts](#cfn-elasticloadbalancing-loadbalancer-policies-instanceports): 
    - String
  [LoadBalancerPorts](#cfn-elasticloadbalancing-loadbalancer-policies-loadbalancerports): 
    - String
  [PolicyName](#cfn-elasticloadbalancing-loadbalancer-policies-policyname): String
  [PolicyType](#cfn-elasticloadbalancing-loadbalancer-policies-policytype): String
```

## Properties
<a name="aws-properties-elasticloadbalancing-loadbalancer-policies-properties"></a>

`Attributes`  <a name="cfn-elasticloadbalancing-loadbalancer-policies-attributes"></a>
The policy attributes.  
*Required*: Yes  
*Type*: Array of Object  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`InstancePorts`  <a name="cfn-elasticloadbalancing-loadbalancer-policies-instanceports"></a>
The instance ports for the policy. Required only for some policy types.  
*Required*: No  
*Type*: Array of String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`LoadBalancerPorts`  <a name="cfn-elasticloadbalancing-loadbalancer-policies-loadbalancerports"></a>
The load balancer ports for the policy. Required only for some policy types.  
*Required*: No  
*Type*: Array of String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`PolicyName`  <a name="cfn-elasticloadbalancing-loadbalancer-policies-policyname"></a>
The name of the policy.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`PolicyType`  <a name="cfn-elasticloadbalancing-loadbalancer-policies-policytype"></a>
The name of the policy type.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## Examples
<a name="aws-properties-elasticloadbalancing-loadbalancer-policies--examples"></a>

### 
<a name="aws-properties-elasticloadbalancing-loadbalancer-policies--examples--"></a>

#### JSON
<a name="aws-properties-elasticloadbalancing-loadbalancer-policies--examples----json"></a>

```
"Policies": [{
    "PolicyName": "My-SSLNegotiation-Policy",
    "PolicyType": "SSLNegotiationPolicyType",
    "Attributes": [{
        "Name": "Reference-Security-Policy",
        "Value": "ELBSecurityPolicy-TLS-1-2-2017-01"
    }]
}]
```

#### YAML
<a name="aws-properties-elasticloadbalancing-loadbalancer-policies--examples----yaml"></a>

```
Policies:
    - PolicyName: My-SSLNegotiation-Policy
      PolicyType: SSLNegotiationPolicyType
      Attributes:
      - Name: Reference-Security-Policy
        Value: ELBSecurityPolicy-TLS-1-2-2017-01
```

## See also
<a name="aws-properties-elasticloadbalancing-loadbalancer-policies--seealso"></a>
+ [CreateLoadBalancerPolicy](https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_CreateLoadBalancerPolicy.html) in the *Elastic Load Balancing API Reference (version 2012-06-01)*



# AWS::ElasticLoadBalancing::LoadBalancer Tag
<a name="aws-properties-elasticloadbalancing-loadbalancer-tag"></a>

Information about a tag.

## Syntax
<a name="aws-properties-elasticloadbalancing-loadbalancer-tag-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-elasticloadbalancing-loadbalancer-tag-syntax.json"></a>

```
{
  "[Key](#cfn-elasticloadbalancing-loadbalancer-tag-key)" : String,
  "[Value](#cfn-elasticloadbalancing-loadbalancer-tag-value)" : String
}
```

### YAML
<a name="aws-properties-elasticloadbalancing-loadbalancer-tag-syntax.yaml"></a>

```
  [Key](#cfn-elasticloadbalancing-loadbalancer-tag-key): String
  [Value](#cfn-elasticloadbalancing-loadbalancer-tag-value): String
```

## Properties
<a name="aws-properties-elasticloadbalancing-loadbalancer-tag-properties"></a>

`Key`  <a name="cfn-elasticloadbalancing-loadbalancer-tag-key"></a>
The key of the tag.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`  
*Minimum*: `1`  
*Maximum*: `128`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Value`  <a name="cfn-elasticloadbalancing-loadbalancer-tag-value"></a>
The value of the tag.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`  
*Minimum*: `0`  
*Maximum*: `256`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)