# Actions
<a name="API_Operations"></a>

The following actions are supported:
+  [AddListenerCertificates](API_AddListenerCertificates.md) 
+  [AddTags](API_AddTags.md) 
+  [AddTrustStoreRevocations](API_AddTrustStoreRevocations.md) 
+  [CreateListener](API_CreateListener.md) 
+  [CreateLoadBalancer](API_CreateLoadBalancer.md) 
+  [CreateRule](API_CreateRule.md) 
+  [CreateTargetGroup](API_CreateTargetGroup.md) 
+  [CreateTrustStore](API_CreateTrustStore.md) 
+  [DeleteListener](API_DeleteListener.md) 
+  [DeleteLoadBalancer](API_DeleteLoadBalancer.md) 
+  [DeleteRule](API_DeleteRule.md) 
+  [DeleteSharedTrustStoreAssociation](API_DeleteSharedTrustStoreAssociation.md) 
+  [DeleteTargetGroup](API_DeleteTargetGroup.md) 
+  [DeleteTrustStore](API_DeleteTrustStore.md) 
+  [DeregisterTargets](API_DeregisterTargets.md) 
+  [DescribeAccountLimits](API_DescribeAccountLimits.md) 
+  [DescribeCapacityReservation](API_DescribeCapacityReservation.md) 
+  [DescribeListenerAttributes](API_DescribeListenerAttributes.md) 
+  [DescribeListenerCertificates](API_DescribeListenerCertificates.md) 
+  [DescribeListeners](API_DescribeListeners.md) 
+  [DescribeLoadBalancerAttributes](API_DescribeLoadBalancerAttributes.md) 
+  [DescribeLoadBalancers](API_DescribeLoadBalancers.md) 
+  [DescribeRules](API_DescribeRules.md) 
+  [DescribeSSLPolicies](API_DescribeSSLPolicies.md) 
+  [DescribeTags](API_DescribeTags.md) 
+  [DescribeTargetGroupAttributes](API_DescribeTargetGroupAttributes.md) 
+  [DescribeTargetGroups](API_DescribeTargetGroups.md) 
+  [DescribeTargetHealth](API_DescribeTargetHealth.md) 
+  [DescribeTrustStoreAssociations](API_DescribeTrustStoreAssociations.md) 
+  [DescribeTrustStoreRevocations](API_DescribeTrustStoreRevocations.md) 
+  [DescribeTrustStores](API_DescribeTrustStores.md) 
+  [GetResourcePolicy](API_GetResourcePolicy.md) 
+  [GetTrustStoreCaCertificatesBundle](API_GetTrustStoreCaCertificatesBundle.md) 
+  [GetTrustStoreRevocationContent](API_GetTrustStoreRevocationContent.md) 
+  [ModifyCapacityReservation](API_ModifyCapacityReservation.md) 
+  [ModifyIpPools](API_ModifyIpPools.md) 
+  [ModifyListener](API_ModifyListener.md) 
+  [ModifyListenerAttributes](API_ModifyListenerAttributes.md) 
+  [ModifyLoadBalancerAttributes](API_ModifyLoadBalancerAttributes.md) 
+  [ModifyRule](API_ModifyRule.md) 
+  [ModifyTargetGroup](API_ModifyTargetGroup.md) 
+  [ModifyTargetGroupAttributes](API_ModifyTargetGroupAttributes.md) 
+  [ModifyTrustStore](API_ModifyTrustStore.md) 
+  [RegisterTargets](API_RegisterTargets.md) 
+  [RemoveListenerCertificates](API_RemoveListenerCertificates.md) 
+  [RemoveTags](API_RemoveTags.md) 
+  [RemoveTrustStoreRevocations](API_RemoveTrustStoreRevocations.md) 
+  [SetIpAddressType](API_SetIpAddressType.md) 
+  [SetRulePriorities](API_SetRulePriorities.md) 
+  [SetSecurityGroups](API_SetSecurityGroups.md) 
+  [SetSubnets](API_SetSubnets.md) 

# AddListenerCertificates
<a name="API_AddListenerCertificates"></a>

Adds the specified SSL server certificate to the certificate list for the specified HTTPS or TLS listener.

If the certificate in already in the certificate list, the call is successful but the certificate is not added again.

To get the certificate list for a listener, use [DescribeListenerCertificates](API_DescribeListenerCertificates.md). To remove certificates from the certificate list for a listener, use [RemoveListenerCertificates](API_RemoveListenerCertificates.md). To replace the default certificate for a listener, use [ModifyListener](API_ModifyListener.md).

For more information, see [SSL certificates](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/https-listener-certificates.html) in the *Application Load Balancers Guide* or [Server certificates](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/tls-listener-certificates.html) in the *Network Load Balancers Guide*.

## Request Parameters
<a name="API_AddListenerCertificates_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **Certificates.member.N**   
The certificate to add. You can specify one certificate per call. Set `CertificateArn` to the certificate ARN but do not set `IsDefault`.  
Type: Array of [Certificate](API_Certificate.md) objects  
Required: Yes

 ** ListenerArn **   
The Amazon Resource Name (ARN) of the listener.  
Type: String  
Required: Yes

## Response Elements
<a name="API_AddListenerCertificates_ResponseElements"></a>

The following element is returned by the service.

 **Certificates.member.N**   
Information about the certificates in the certificate list.  
Type: Array of [Certificate](API_Certificate.md) objects

## Errors
<a name="API_AddListenerCertificates_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** CertificateNotFound **   
The specified certificate does not exist.  
HTTP Status Code: 400

 ** ListenerNotFound **   
The specified listener does not exist.  
HTTP Status Code: 400

 ** TooManyCertificates **   
You've reached the limit on the number of certificates per load balancer.  
HTTP Status Code: 400

## See Also
<a name="API_AddListenerCertificates_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/AddListenerCertificates) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/AddListenerCertificates) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/AddListenerCertificates) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/AddListenerCertificates) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/AddListenerCertificates) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/AddListenerCertificates) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/AddListenerCertificates) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/AddListenerCertificates) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/AddListenerCertificates) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/AddListenerCertificates) 

# AddTags
<a name="API_AddTags"></a>

Adds the specified tags to the specified Elastic Load Balancing resource. You can tag your Application Load Balancers, Network Load Balancers, Gateway Load Balancers, target groups, trust stores, listeners, and rules.

Each tag consists of a key and an optional value. If a resource already has a tag with the same key, `AddTags` updates its value.

To list the current tags for your resources, use [DescribeTags](API_DescribeTags.md). To remove tags from your resources, use [RemoveTags](API_RemoveTags.md).

## Request Parameters
<a name="API_AddTags_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **ResourceArns.member.N**   
The Amazon Resource Name (ARN) of the resource.  
Type: Array of strings  
Required: Yes

 **Tags.member.N**   
The tags.  
Type: Array of [Tag](API_Tag.md) objects  
Array Members: Minimum number of 1 item.  
Required: Yes

## Errors
<a name="API_AddTags_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DuplicateTagKeys **   
A tag key was specified more than once.  
HTTP Status Code: 400

 ** ListenerNotFound **   
The specified listener does not exist.  
HTTP Status Code: 400

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

 ** RuleNotFound **   
The specified rule does not exist.  
HTTP Status Code: 400

 ** TargetGroupNotFound **   
The specified target group does not exist.  
HTTP Status Code: 400

 ** TooManyTags **   
You've reached the limit on the number of tags for this resource.  
HTTP Status Code: 400

 ** TrustStoreNotFound **   
The specified trust store does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_AddTags_Examples"></a>

### Add tags to a load balancer
<a name="API_AddTags_Example_1"></a>

This example adds the specified tags to the specified load balancer.

#### Sample Request
<a name="API_AddTags_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=AddTags
&ResourceArns.member.1=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Tags.member.1.Key=project
&Tags.member.1.Value=lima
&Tags.member.2.Key=department
&Tags.member.2.Value=digital-media
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_AddTags_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/AddTags) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/AddTags) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/AddTags) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/AddTags) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/AddTags) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/AddTags) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/AddTags) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/AddTags) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/AddTags) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/AddTags) 

# AddTrustStoreRevocations
<a name="API_AddTrustStoreRevocations"></a>

Adds the specified revocation file to the specified trust store.

## Request Parameters
<a name="API_AddTrustStoreRevocations_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **RevocationContents.member.N**   
The revocation file to add.  
Type: Array of [RevocationContent](API_RevocationContent.md) objects  
Required: No

 ** TrustStoreArn **   
The Amazon Resource Name (ARN) of the trust store.  
Type: String  
Required: Yes

## Response Elements
<a name="API_AddTrustStoreRevocations_ResponseElements"></a>

The following element is returned by the service.

 **TrustStoreRevocations.member.N**   
Information about the revocation file added to the trust store.  
Type: Array of [TrustStoreRevocation](API_TrustStoreRevocation.md) objects

## Errors
<a name="API_AddTrustStoreRevocations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidRevocationContent **   
The provided revocation file is an invalid format, or uses an incorrect algorithm.  
HTTP Status Code: 400

 ** RevocationContentNotFound **   
The specified revocation file does not exist.  
HTTP Status Code: 400

 ** TooManyTrustStoreRevocationEntries **   
The specified trust store has too many revocation entries.  
HTTP Status Code: 400

 ** TrustStoreNotFound **   
The specified trust store does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_AddTrustStoreRevocations_Examples"></a>

### Add a revocation file to a trust store.
<a name="API_AddTrustStoreRevocations_Example_1"></a>

This example adds the specified certificate revocation list to the specified trust store.

#### Sample Request
<a name="API_AddTrustStoreRevocations_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=AddTrustStoreRevocations
&TrustStoreArn=arn:aws:elasticloadbalancing:us-east-1:111122223333:truststore/my-trust-store/3ym756xh7yj
&RevocationContents.member.1.RevocationType=CRL
&RevocationContents.member.1.S3Bucket=amzn-s3-demo-bucket
&RevocationContents.member.1.S3Key=my-crl.pem
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_AddTrustStoreRevocations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/AddTrustStoreRevocations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/AddTrustStoreRevocations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/AddTrustStoreRevocations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/AddTrustStoreRevocations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/AddTrustStoreRevocations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/AddTrustStoreRevocations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/AddTrustStoreRevocations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/AddTrustStoreRevocations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/AddTrustStoreRevocations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/AddTrustStoreRevocations) 

# CreateListener
<a name="API_CreateListener"></a>

Creates a listener for the specified Application Load Balancer, Network Load Balancer, or Gateway Load Balancer.

To update a listener, use [ModifyListener](API_ModifyListener.md). When you are finished with a listener, you can delete it using [DeleteListener](API_DeleteListener.md). If you are finished with both the listener and the load balancer, you can delete them both using [DeleteLoadBalancer](API_DeleteLoadBalancer.md).

For more information, see the following:
+  [Listeners for your Application Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-listeners.html) 
+  [Listeners for your Network Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-listeners.html) 
+  [Listeners for your Gateway Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/gateway-listeners.html) 

This operation is idempotent, which means that it completes at most one time. If you attempt to create multiple listeners with the same settings, each call succeeds.

## Request Parameters
<a name="API_CreateListener_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **AlpnPolicy.member.N**   
[TLS listeners] The name of the Application-Layer Protocol Negotiation (ALPN) policy. You can specify one policy name. The following are the possible values:  
+  `HTTP1Only` 
+  `HTTP2Only` 
+  `HTTP2Optional` 
+  `HTTP2Preferred` 
+  `None` 
For more information, see [ALPN policies](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-listeners.html#alpn-policies) in the *Network Load Balancers Guide*.  
Type: Array of strings  
Required: No

 **Certificates.member.N**   
[HTTPS and TLS listeners] The default certificate for the listener. You must provide exactly one certificate. Set `CertificateArn` to the certificate ARN but do not set `IsDefault`.  
To create a certificate list for the listener, use [AddListenerCertificates](API_AddListenerCertificates.md).  
Type: Array of [Certificate](API_Certificate.md) objects  
Required: No

 **DefaultActions.member.N**   
The actions for the default rule.  
Type: Array of [Action](API_Action.md) objects  
Required: Yes

 ** LoadBalancerArn **   
The Amazon Resource Name (ARN) of the load balancer.  
Type: String  
Required: Yes

 ** MutualAuthentication **   
[HTTPS listeners] The mutual authentication configuration information.  
Type: [MutualAuthenticationAttributes](API_MutualAuthenticationAttributes.md) object  
Required: No

 ** Port **   
The port on which the load balancer is listening. You can't specify a port for a Gateway Load Balancer.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 65535.  
Required: No

 ** Protocol **   
The protocol for connections from clients to the load balancer. For Application Load Balancers, the supported protocols are HTTP and HTTPS. For Network Load Balancers, the supported protocols are TCP, TLS, UDP, TCP\$1UDP, QUIC, and TCP\$1QUIC. You can’t specify the UDP, TCP\$1UDP, QUIC, or TCP\$1QUIC protocol if dual-stack mode is enabled. You can't specify a protocol for a Gateway Load Balancer.  
Type: String  
Valid Values: `HTTP | HTTPS | TCP | TLS | UDP | TCP_UDP | GENEVE | QUIC | TCP_QUIC`   
Required: No

 ** SslPolicy **   
[HTTPS and TLS listeners] The security policy that defines which protocols and ciphers are supported.  
For more information, see [Security policies](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/describe-ssl-policies.html) in the *Application Load Balancers Guide* and [Security policies](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/describe-ssl-policies.html) in the *Network Load Balancers Guide*.  
Type: String  
Required: No

 **Tags.member.N**   
The tags to assign to the listener.  
Type: Array of [Tag](API_Tag.md) objects  
Array Members: Minimum number of 1 item.  
Required: No

## Response Elements
<a name="API_CreateListener_ResponseElements"></a>

The following element is returned by the service.

 **Listeners.member.N**   
Information about the listener.  
Type: Array of [Listener](API_Listener.md) objects

## Errors
<a name="API_CreateListener_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ALPNPolicyNotFound **   
The specified ALPN policy is not supported.  
HTTP Status Code: 400

 ** CertificateNotFound **   
The specified certificate does not exist.  
HTTP Status Code: 400

 ** DuplicateListener **   
A listener with the specified port already exists.  
HTTP Status Code: 400

 ** IncompatibleProtocols **   
The specified configuration is not valid with this protocol.  
HTTP Status Code: 400

 ** InvalidConfigurationRequest **   
The requested configuration is not valid.  
HTTP Status Code: 400

 ** InvalidLoadBalancerAction **   
The requested action is not valid.  
HTTP Status Code: 400

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

 ** SSLPolicyNotFound **   
The specified SSL policy does not exist.  
HTTP Status Code: 400

 ** TargetGroupAssociationLimit **   
You've reached the limit on the number of load balancers per target group.  
HTTP Status Code: 400

 ** TargetGroupNotFound **   
The specified target group does not exist.  
HTTP Status Code: 400

 ** TooManyActions **   
You've reached the limit on the number of actions per rule.  
HTTP Status Code: 400

 ** TooManyCertificates **   
You've reached the limit on the number of certificates per load balancer.  
HTTP Status Code: 400

 ** TooManyListeners **   
You've reached the limit on the number of listeners per load balancer.  
HTTP Status Code: 400

 ** TooManyRegistrationsForTargetId **   
You've reached the limit on the number of times a target can be registered with a load balancer.  
HTTP Status Code: 400

 ** TooManyTags **   
You've reached the limit on the number of tags for this resource.  
HTTP Status Code: 400

 ** TooManyTargets **   
You've reached the limit on the number of targets.  
HTTP Status Code: 400

 ** TooManyUniqueTargetGroupsPerLoadBalancer **   
You've reached the limit on the number of unique target groups per load balancer across all listeners. If a target group is used by multiple actions for a load balancer, it is counted as only one use.  
HTTP Status Code: 400

 ** TrustStoreNotFound **   
The specified trust store does not exist.  
HTTP Status Code: 400

 ** TrustStoreNotReady **   
The specified trust store is not active.  
HTTP Status Code: 400

 ** UnsupportedProtocol **   
The specified protocol is not supported.  
HTTP Status Code: 400

## Examples
<a name="API_CreateListener_Examples"></a>

### Create an HTTP listener
<a name="API_CreateListener_Example_1"></a>

This example creates an HTTP listener for the specified Application Load Balancer that forwards requests to the specified target group.

#### Sample Request
<a name="API_CreateListener_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateListener
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Protocol=HTTP
&Port=80
&DefaultActions.member.1.Type=forward
&DefaultActions.member.1.TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_CreateListener_Example_1_Response"></a>

```
<CreateListenerResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <CreateListenerResult> 
    <Listeners> 
      <member> 
        <LoadBalancerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188</LoadBalancerArn> 
        <Protocol>HTTP</Protocol> 
        <Port>80</Port> 
        <ListenerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2</ListenerArn> 
        <DefaultActions> 
          <member> 
            <Type>forward</Type> 
            <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067</TargetGroupArn> 
          </member> 
        </DefaultActions> 
      </member> 
    </Listeners> 
  </CreateListenerResult> 
  <ResponseMetadata> 
    <RequestId>883c84bb-f387-11e5-ae48-cff02092876b</RequestId> 
  </ResponseMetadata> 
</CreateListenerResponse>
```

### Create an HTTPS listener
<a name="API_CreateListener_Example_2"></a>

This example creates an HTTPS listener for the specified Application Load Balancer that forwards requests to the specified target group. Note that you must specify a default certificate for an HTTPS listener. You can create and manage your certificates using AWS Certificate Manager (ACM). Alternatively, you can create a certificate using SSL/TLS tools, get the certificate signed by a certificate authority (CA), and upload the certificate to AWS Identity and Access Management (IAM).

#### Sample Request
<a name="API_CreateListener_Example_2_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateListener
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Protocol=HTTPS
&Port=443
&Certificates.member.1.CertificateArn=arn:aws:iam::123456789012:server-certificate/my-server-cert
&SslPolicy=ELBSecurityPolicy-2016-08
&DefaultActions.member.1.Type=forward
&DefaultActions.member.1.TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_CreateListener_Example_2_Response"></a>

```
<CreateListenerResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <CreateListenerResult> 
    <Listeners> 
      <member> 
        <LoadBalancerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188</LoadBalancerArn> 
        <Protocol>HTTPS</Protocol> 
        <Certificates>
          <member>
            <CertificateArn>arn:aws:iam::123456789012:server-certificate/my-server-cert</CertificateArn>
          </member>
        </Certificates>
        <Port>443</Port>
        <SslPolicy>ELBSecurityPolicy-2016-08</SslPolicy>
        <ListenerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2</ListenerArn> 
        <DefaultActions> 
          <member> 
            <Type>forward</Type> 
            <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067</TargetGroupArn> 
          </member> 
        </DefaultActions> 
      </member> 
    </Listeners> 
  </CreateListenerResult> 
  <ResponseMetadata> 
    <RequestId>97f1bb38-f390-11e5-b95d-3b2c1831fc26</RequestId> 
  </ResponseMetadata> 
</CreateListenerResponse>
```

### Create a TCP listener
<a name="API_CreateListener_Example_3"></a>

This example creates a TCP listener for the specified Network Load Balancer that forwards requests to the specified target group.

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateListener
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/net/my-network-load-balancer/2d7b630a7815dda2
&Protocol=TCP
&Port=80
&DefaultActions.member.1.Type=forward
&DefaultActions.member.1.TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-tcp-targets/b7fce90c666d892a
&Version=2015-12-01
&AUTHPARAMS
```

### Create a TLS listener
<a name="API_CreateListener_Example_4"></a>

This example creates a TLS listener for the specified Network Load Balancer that forwards requests to the specified target group.

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateListener
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/net/my-network-load-balancer/2d7b630a7815dda2
&Protocol=TLS
&Port=443
&Certificates.member.1.CertificateArn=arn:aws:acm::123456789012:server-certificate/my-server-cert
&SslPolicy=ELBSecurityPolicy-2016-08
&DefaultActions.member.1.Type=forward
&DefaultActions.member.1.TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-tls-targets/b7fce90c666d892a
&Version=2015-12-01
&AUTHPARAMS
```

### Create a UDP listener
<a name="API_CreateListener_Example_5"></a>

This example creates a UDP listener for the specified Network Load Balancer that forwards requests to the specified target group.

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateListener
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/net/my-network-load-balancer/2d7b630a7815dda2
&Protocol=UDP
&Port=53
&DefaultActions.member.1.Type=forward
&DefaultActions.member.1.TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-udp-targets/b7fce90c666d892a
&Version=2015-12-01
&AUTHPARAMS
```

### Create a TCP\$1UDP listener
<a name="API_CreateListener_Example_6"></a>

This example creates a TCP\$1UDP listener for the specified Network Load Balancer that forwards requests to the specified target group. The target group must use the TCP\$1UDP protocol.

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateListener
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/net/my-network-load-balancer/2d7b630a7815dda2
&Protocol=TCP_UDP
&Port=80
&DefaultActions.member.1.Type=forward
&DefaultActions.member.1.TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-tcp-udp-targets/b7fce90c666d892a
&Version=2015-12-01
&AUTHPARAMS
```

### Create a listener for your Gateway Load Balancer
<a name="API_CreateListener_Example_7"></a>

This example creates a listener for the specified Gateway Load Balancer that forwards requests to the specified target group. You can't specify a port or protocol.

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateListener
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/gwy/my-gateway-load-balancer/2d7b630a7815dda2
&DefaultActions.member.1.Type=forward
&DefaultActions.member.1.TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-appliance-targets/b7fce90c666d892a
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_CreateListener_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/CreateListener) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/CreateListener) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/CreateListener) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/CreateListener) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/CreateListener) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/CreateListener) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/CreateListener) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/CreateListener) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/CreateListener) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/CreateListener) 

# CreateLoadBalancer
<a name="API_CreateLoadBalancer"></a>

Creates an Application Load Balancer, Network Load Balancer, or Gateway Load Balancer.

To create listeners for your load balancer, use [CreateListener](API_CreateListener.md). To describe your current load balancers, see [DescribeLoadBalancers](API_DescribeLoadBalancers.md). When you are finished with a load balancer, you can delete it using [DeleteLoadBalancer](API_DeleteLoadBalancer.md).

For more information, see the following:
+  [Application Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/application-load-balancers.html) 
+  [Network Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancers.html) 
+  [Gateway Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/gateway-load-balancers.html) 

This operation is idempotent, which means that it completes at most one time. If you attempt to create multiple load balancers with the same settings, each call succeeds.

## Request Parameters
<a name="API_CreateLoadBalancer_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** CustomerOwnedIpv4Pool **   
[Application Load Balancers on Outposts] The ID of the customer-owned address pool (CoIP pool).  
Type: String  
Length Constraints: Maximum length of 256.  
Pattern: `^(ipv4pool-coip-)[a-zA-Z0-9]+$`   
Required: No

 ** EnablePrefixForIpv6SourceNat **   
[Network Load Balancers with UDP listeners] Indicates whether to use an IPv6 prefix from each subnet for source NAT. The IP address type must be `dualstack`. The default value is `off`.  
Type: String  
Valid Values: `on | off`   
Required: No

 ** IpAddressType **   
The IP address type. Internal load balancers must use `ipv4`.  
[Application Load Balancers] The possible values are `ipv4` (IPv4 addresses), `dualstack` (IPv4 and IPv6 addresses), and `dualstack-without-public-ipv4` (public IPv6 addresses and private IPv4 and IPv6 addresses).  
[Network Load Balancers and Gateway Load Balancers] The possible values are `ipv4` (IPv4 addresses) and `dualstack` (IPv4 and IPv6 addresses).  
Type: String  
Valid Values: `ipv4 | dualstack | dualstack-without-public-ipv4`   
Required: No

 ** IpamPools **   
[Application Load Balancers] The IPAM pools to use with the load balancer.  
Type: [IpamPools](API_IpamPools.md) object  
Required: No

 ** Name **   
The name of the load balancer.  
This name must be unique per region per account, can have a maximum of 32 characters, must contain only alphanumeric characters or hyphens, must not begin or end with a hyphen, and must not begin with "internal-".  
Type: String  
Required: Yes

 ** Scheme **   
The nodes of an Internet-facing load balancer have public IP addresses. The DNS name of an Internet-facing load balancer is publicly resolvable to the public IP addresses of the nodes. Therefore, Internet-facing load balancers can route requests from clients over the internet.  
The nodes of an internal load balancer have only private IP addresses. The DNS name of an internal load balancer is publicly resolvable to the private IP addresses of the nodes. Therefore, internal load balancers can route requests only from clients with access to the VPC for the load balancer.  
The default is an Internet-facing load balancer.  
You can't specify a scheme for a Gateway Load Balancer.  
Type: String  
Valid Values: `internet-facing | internal`   
Required: No

 **SecurityGroups.member.N**   
[Application Load Balancers and Network Load Balancers] The IDs of the security groups for the load balancer.  
Type: Array of strings  
Required: No

 **SubnetMappings.member.N**   
The IDs of the subnets. You can specify only one subnet per Availability Zone. You must specify either subnets or subnet mappings, but not both.  
[Application Load Balancers] You must specify subnets from at least two Availability Zones. You can't specify Elastic IP addresses for your subnets.  
[Application Load Balancers on Outposts] You must specify one Outpost subnet.  
[Application Load Balancers on Local Zones] You can specify subnets from one or more Local Zones.  
[Network Load Balancers] You can specify subnets from one or more Availability Zones. You can specify one Elastic IP address per subnet if you need static IP addresses for your internet-facing load balancer. For internal load balancers, you can specify one private IP address per subnet from the IPv4 range of the subnet. For internet-facing load balancer, you can specify one IPv6 address per subnet.  
[Gateway Load Balancers] You can specify subnets from one or more Availability Zones. You can't specify Elastic IP addresses for your subnets.  
Type: Array of [SubnetMapping](API_SubnetMapping.md) objects  
Required: No

 **Subnets.member.N**   
The IDs of the subnets. You can specify only one subnet per Availability Zone. You must specify either subnets or subnet mappings, but not both. To specify an Elastic IP address, specify subnet mappings instead of subnets.  
[Application Load Balancers] You must specify subnets from at least two Availability Zones.  
[Application Load Balancers on Outposts] You must specify one Outpost subnet.  
[Application Load Balancers on Local Zones] You can specify subnets from one or more Local Zones.  
[Network Load Balancers and Gateway Load Balancers] You can specify subnets from one or more Availability Zones.  
Type: Array of strings  
Required: No

 **Tags.member.N**   
The tags to assign to the load balancer.  
Type: Array of [Tag](API_Tag.md) objects  
Array Members: Minimum number of 1 item.  
Required: No

 ** Type **   
The type of load balancer. The default is `application`.  
Type: String  
Valid Values: `application | network | gateway`   
Required: No

## Response Elements
<a name="API_CreateLoadBalancer_ResponseElements"></a>

The following element is returned by the service.

 **LoadBalancers.member.N**   
Information about the load balancer.  
Type: Array of [LoadBalancer](API_LoadBalancer.md) objects

## Errors
<a name="API_CreateLoadBalancer_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AllocationIdNotFound **   
The specified allocation ID does not exist.  
HTTP Status Code: 400

 ** AvailabilityZoneNotSupported **   
The specified Availability Zone is not supported.  
HTTP Status Code: 400

 ** DuplicateLoadBalancerName **   
A load balancer with the specified name already exists.  
HTTP Status Code: 400

 ** DuplicateTagKeys **   
A tag key was specified more than once.  
HTTP Status Code: 400

 ** InvalidConfigurationRequest **   
The requested configuration is not valid.  
HTTP Status Code: 400

 ** InvalidScheme **   
The requested scheme is not valid.  
HTTP Status Code: 400

 ** InvalidSecurityGroup **   
The specified security group does not exist.  
HTTP Status Code: 400

 ** InvalidSubnet **   
The specified subnet is out of available addresses.  
HTTP Status Code: 400

 ** OperationNotPermitted **   
This operation is not allowed.  
HTTP Status Code: 400

 ** ResourceInUse **   
A specified resource is in use.  
HTTP Status Code: 400

 ** SubnetNotFound **   
The specified subnet does not exist.  
HTTP Status Code: 400

 ** TooManyLoadBalancers **   
You've reached the limit on the number of load balancers for your AWS account.  
HTTP Status Code: 400

 ** TooManyTags **   
You've reached the limit on the number of tags for this resource.  
HTTP Status Code: 400

## Examples
<a name="API_CreateLoadBalancer_Examples"></a>

### Create an Internet-facing load balancer
<a name="API_CreateLoadBalancer_Example_1"></a>

This example creates an Internet-facing load balancer and enables the Availability Zones for the specified subnets.

#### Sample Request
<a name="API_CreateLoadBalancer_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateLoadBalancer
&Name=my-load-balancer
&Subnets.member.1=subnet-8360a9e7
&Subnets.member.2=subnet-b7d581c0
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_CreateLoadBalancer_Example_1_Response"></a>

```
<CreateLoadBalancerResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <CreateLoadBalancerResult>
    <LoadBalancers> 
      <member> 
        <LoadBalancerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-internal-load-balancer/50dc6c495c0c9188</LoadBalancerArn> 
        <Scheme>internet-facing</Scheme> 
        <LoadBalancerName>my-load-balancer</LoadBalancerName> 
        <VpcId>vpc-3ac0fb5f</VpcId> 
        <CanonicalHostedZoneId>Z2P70J7EXAMPLE</CanonicalHostedZoneId> 
        <CreatedTime>2016-03-25T21:29:48.850Z</CreatedTime> 
        <AvailabilityZones> 
          <member> 
            <SubnetId>subnet-8360a9e7</SubnetId> 
            <ZoneName>us-west-2a</ZoneName> 
          </member> 
          <member> 
            <SubnetId>subnet-b7d581c0</SubnetId> 
            <ZoneName>us-west-2b</ZoneName> 
          </member> 
        </AvailabilityZones> 
        <SecurityGroups> 
          <member>sg-5943793c</member> 
        </SecurityGroups> 
        <DNSName>my-load-balancer-424835706.us-west-2.elb.amazonaws.com</DNSName> 
        <State> 
          <Code>provisioning</Code> 
        </State> 
        <Type>application</Type> 
      </member> 
    </LoadBalancers> 
  </CreateLoadBalancerResult> 
  <ResponseMetadata> 
    <RequestId>32d531b2-f2d0-11e5-9192-3fff33344cfa</RequestId> 
  </ResponseMetadata>
</CreateLoadBalancerResponse>
```

### Create an internal load balancer
<a name="API_CreateLoadBalancer_Example_2"></a>

This example creates an internal load balancer and enables the Availability Zones for the specified subnets.

#### Sample Request
<a name="API_CreateLoadBalancer_Example_2_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateLoadBalancer
&Name=my-internal-load-balancer
&Scheme=internal
&Subnets.member.1=subnet-8360a9e7
&Subnets.member.2=subnet-b7d581c0
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_CreateLoadBalancer_Example_2_Response"></a>

```
<CreateLoadBalancerResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <CreateLoadBalancerResult>
    <LoadBalancers> 
      <member> 
        <LoadBalancerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-internal-load-balancer/5b49b8d4303115c2</LoadBalancerArn> 
        <Scheme>internal</Scheme> 
        <LoadBalancerName>my-internal-load-balancer</LoadBalancerName> 
        <VpcId>vpc-3ac0fb5f</VpcId> 
        <CanonicalHostedZoneId>Z2P70J7EXAMPLE</CanonicalHostedZoneId> 
        <CreatedTime>2016-03-25T21:29:48.850Z</CreatedTime> 
        <AvailabilityZones> 
          <member> 
            <SubnetId>subnet-8360a9e7</SubnetId> 
            <ZoneName>us-west-2a</ZoneName> 
          </member> 
          <member> 
            <SubnetId>subnet-b7d581c0</SubnetId> 
            <ZoneName>us-west-2b</ZoneName> 
          </member> 
        </AvailabilityZones> 
        <SecurityGroups> 
          <member>sg-5943793c</member> 
        </SecurityGroups> 
        <DNSName>internal-my-internal-load-balancer-1529930873.us-west-2.elb.amazonaws.com</DNSName> 
        <State> 
          <Code>provisioning</Code> 
        </State> 
        <Type>application</Type> 
      </member> 
    </LoadBalancers> 
  </CreateLoadBalancerResult> 
  <ResponseMetadata> 
    <RequestId>b37b9c3e-f2d0-11e5-a53c-67205c0d10fd</RequestId> 
  </ResponseMetadata>
</CreateLoadBalancerResponse>
```

### Create a Network Load Balancer
<a name="API_CreateLoadBalancer_Example_3"></a>

This example creates a Network Load Balancer and associates an Elastic IP address with each of the specified subnets.

#### Sample Request
<a name="API_CreateLoadBalancer_Example_3_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateLoadBalancer
&Name=my-network-load-balancer
&Type=network
&SubnetMappings.member.1.SubnetId=subnet-8360a9e7
&SubnetMappings.member.1.AllocationId=eipalloc-5723d13e
&SubnetMappings.member.2.SubnetId=subnet-b7d581c0
&SubnetMappings.member.2.AllocationId=eipalloc-fc5ca095
&Version=2015-12-01
&AUTHPARAMS
```

### Create a Gateway Load Balancer
<a name="API_CreateLoadBalancer_Example_4"></a>

This example creates a Gateway Load Balancer.

#### Sample Request
<a name="API_CreateLoadBalancer_Example_4_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateLoadBalancer
&Name=my-gateway-load-balancer
&Type=gateway
&Subnets.member.1.SubnetId=subnet-066877671789bd71b
&Subnets.member.2.SubnetId=subnet-09ed24a70bc19bbe4
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_CreateLoadBalancer_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/CreateLoadBalancer) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/CreateLoadBalancer) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/CreateLoadBalancer) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/CreateLoadBalancer) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/CreateLoadBalancer) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/CreateLoadBalancer) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/CreateLoadBalancer) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/CreateLoadBalancer) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/CreateLoadBalancer) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/CreateLoadBalancer) 

# CreateRule
<a name="API_CreateRule"></a>

Creates a rule for the specified listener. The listener must be associated with an Application Load Balancer.

Each rule consists of a priority, one or more actions, one or more conditions, and up to two optional transforms. Rules are evaluated in priority order, from the lowest value to the highest value. When the conditions for a rule are met, its actions are performed. If the conditions for no rules are met, the actions for the default rule are performed. For more information, see [Listener rules](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-listeners.html#listener-rules) in the *Application Load Balancers Guide*.

To view your current rules, use [DescribeRules](API_DescribeRules.md). To update a rule, use [ModifyRule](API_ModifyRule.md). To set the priorities of your rules, use [SetRulePriorities](API_SetRulePriorities.md). To delete a rule, use [DeleteRule](API_DeleteRule.md).

## Request Parameters
<a name="API_CreateRule_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **Actions.member.N**   
The actions.  
Type: Array of [Action](API_Action.md) objects  
Required: Yes

 **Conditions.member.N**   
The conditions.  
Type: Array of [RuleCondition](API_RuleCondition.md) objects  
Required: Yes

 ** ListenerArn **   
The Amazon Resource Name (ARN) of the listener.  
Type: String  
Required: Yes

 ** Priority **   
The rule priority. A listener can't have multiple rules with the same priority.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 50000.  
Required: Yes

 **Tags.member.N**   
The tags to assign to the rule.  
Type: Array of [Tag](API_Tag.md) objects  
Array Members: Minimum number of 1 item.  
Required: No

 **Transforms.member.N**   
The transforms to apply to requests that match this rule. You can add one host header rewrite transform and one URL rewrite transform.  
Type: Array of [RuleTransform](API_RuleTransform.md) objects  
Required: No

## Response Elements
<a name="API_CreateRule_ResponseElements"></a>

The following element is returned by the service.

 **Rules.member.N**   
Information about the rule.  
Type: Array of [Rule](API_Rule.md) objects

## Errors
<a name="API_CreateRule_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** IncompatibleProtocols **   
The specified configuration is not valid with this protocol.  
HTTP Status Code: 400

 ** InvalidConfigurationRequest **   
The requested configuration is not valid.  
HTTP Status Code: 400

 ** InvalidLoadBalancerAction **   
The requested action is not valid.  
HTTP Status Code: 400

 ** ListenerNotFound **   
The specified listener does not exist.  
HTTP Status Code: 400

 ** PriorityInUse **   
The specified priority is in use.  
HTTP Status Code: 400

 ** TargetGroupAssociationLimit **   
You've reached the limit on the number of load balancers per target group.  
HTTP Status Code: 400

 ** TargetGroupNotFound **   
The specified target group does not exist.  
HTTP Status Code: 400

 ** TooManyActions **   
You've reached the limit on the number of actions per rule.  
HTTP Status Code: 400

 ** TooManyRegistrationsForTargetId **   
You've reached the limit on the number of times a target can be registered with a load balancer.  
HTTP Status Code: 400

 ** TooManyRules **   
You've reached the limit on the number of rules per load balancer.  
HTTP Status Code: 400

 ** TooManyTags **   
You've reached the limit on the number of tags for this resource.  
HTTP Status Code: 400

 ** TooManyTargetGroups **   
You've reached the limit on the number of target groups for your AWS account.  
HTTP Status Code: 400

 ** TooManyTargets **   
You've reached the limit on the number of targets.  
HTTP Status Code: 400

 ** TooManyUniqueTargetGroupsPerLoadBalancer **   
You've reached the limit on the number of unique target groups per load balancer across all listeners. If a target group is used by multiple actions for a load balancer, it is counted as only one use.  
HTTP Status Code: 400

 ** UnsupportedProtocol **   
The specified protocol is not supported.  
HTTP Status Code: 400

## Examples
<a name="API_CreateRule_Examples"></a>

### Create a rule that forwards to a target group if a condition is met
<a name="API_CreateRule_Example_1"></a>

This example creates a rule that forwards requests to the specified target group if the URL contains the specified pattern (for example, /img/\$1).

#### Sample Request
<a name="API_CreateRule_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateRule
&ListenerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2
&Priority=10
&Conditions.member.1.Field=path-pattern
&Conditions.member.1.Values.member.1=/img/*
&Actions.member.1.Type=forward
&Actions.member.1.TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_CreateRule_Example_1_Response"></a>

```
<CreateRuleResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <CreateRuleResult> 
    <Rules> 
      <member> 
        <IsDefault>false</IsDefault> 
        <Conditions> 
          <member> 
            <Field>path-pattern</Field> 
            <Values> 
              <member>/img/*</member> 
            </Values> 
          </member> 
        </Conditions> 
        <Priority>10</Priority> 
        <Actions> 
          <member> 
            <Type>forward</Type> 
            <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067</TargetGroupArn> 
          </member> 
        </Actions> 
        <RuleArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee</RuleArn> 
      </member> 
    </Rules> 
  </CreateRuleResult> 
  <ResponseMetadata> 
    <RequestId>c5478c83-f397-11e5-bb98-57195a6eb84a</RequestId> 
  </ResponseMetadata>
</CreateRuleResponse>
```

### Create a rule with a forward rule and an authenticate-oidc rule
<a name="API_CreateRule_Example_2"></a>

This example creates a rule that first authenticates the user and then forwards the request if the user is authenticated.

#### Sample Request
<a name="API_CreateRule_Example_2_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateRule
&ListenerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2
&Priority=10
&Actions.member.1.Type=authenticate-oidc
&Actions.member.1.AuthenticateOidcConfig.Issuer="https://idp-issuer.com"
&Actions.member.1.AuthenticateOidcConfig.AuthorizationEndpoint="https://authorization-endpoint.com"
&Actions.member.1.AuthenticateOidcConfig.TokenEndpoint="https://token-endpoint.com"
&Actions.member.1.AuthenticateOidcConfig.UserInfoEndpoint="https://user-info-endpoint.com"
&Actions.member.1.AuthenticateOidcConfig.ClientId="abcdefghijklmnopqrstuvwxyz123456789"
&Actions.member.1.AuthenticateOidcConfig.ClientSecret="123456789012345678901234567890"
&Actions.member.1.AuthenticateOidcConfig.SessionTimeout=3600
&Actions.member.1.AuthenticateOidcConfig.Scope="email"
&Actions.member.1.AuthenticateOidcConfig.OnUnauthenticatedRequest="authenticate"
&Actions.member.1.Order=1
&Actions.member.2.Type=forward
&Actions.member.2.TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Actions.member.2.Order=2
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_CreateRule_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/CreateRule) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/CreateRule) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/CreateRule) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/CreateRule) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/CreateRule) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/CreateRule) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/CreateRule) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/CreateRule) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/CreateRule) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/CreateRule) 

# CreateTargetGroup
<a name="API_CreateTargetGroup"></a>

Creates a target group.

To register targets with the target group, use [RegisterTargets](API_RegisterTargets.md). To update the health check settings for the target group, use [ModifyTargetGroup](API_ModifyTargetGroup.md). To monitor the health of targets in the target group, use [DescribeTargetHealth](API_DescribeTargetHealth.md).

To route traffic to the targets in a target group, specify the target group in an action using [CreateListener](API_CreateListener.md) or [CreateRule](API_CreateRule.md).

To delete a target group, use [DeleteTargetGroup](API_DeleteTargetGroup.md).

For more information, see the following:
+  [Target groups for your Application Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html) 
+  [Target groups for your Network Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-target-groups.html) 
+  [Target groups for your Gateway Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/target-groups.html) 

This operation is idempotent, which means that it completes at most one time. If you attempt to create multiple target groups with the same settings, each call succeeds.

## Request Parameters
<a name="API_CreateTargetGroup_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** HealthCheckEnabled **   
Indicates whether health checks are enabled. If the target type is `lambda`, health checks are disabled by default but can be enabled. If the target type is `instance`, `ip`, or `alb`, health checks are always enabled and can't be disabled.  
Type: Boolean  
Required: No

 ** HealthCheckIntervalSeconds **   
The approximate amount of time, in seconds, between health checks of an individual target. The range is 5-300. If the target group protocol is TCP, TLS, UDP, TCP\$1UDP, QUIC, TCP\$1QUIC, HTTP or HTTPS, the default is 30 seconds. If the target group protocol is GENEVE, the default is 10 seconds. If the target type is `lambda`, the default is 35 seconds.  
Type: Integer  
Valid Range: Minimum value of 5. Maximum value of 300.  
Required: No

 ** HealthCheckPath **   
[HTTP/HTTPS health checks] The destination for health checks on the targets.  
[HTTP1 or HTTP2 protocol version] The ping path. The default is /.  
[GRPC protocol version] The path of a custom health check method with the format /package.service/method. The default is /AWS.ALB/healthcheck.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** HealthCheckPort **   
The port the load balancer uses when performing health checks on targets. If the protocol is HTTP, HTTPS, TCP, TLS, UDP, TCP\$1UDP, QUIC, or TCP\$1QUIC the default is `traffic-port`, which is the port on which each target receives traffic from the load balancer. If the protocol is GENEVE, the default is port 80.  
Type: String  
Required: No

 ** HealthCheckProtocol **   
The protocol the load balancer uses when performing health checks on targets. For Application Load Balancers, the default is HTTP. For Network Load Balancers and Gateway Load Balancers, the default is TCP. The TCP protocol is not supported for health checks if the protocol of the target group is HTTP or HTTPS. The GENEVE, TLS, UDP, TCP\$1UDP, QUIC, and TCP\$1QUIC protocols are not supported for health checks.  
Type: String  
Valid Values: `HTTP | HTTPS | TCP | TLS | UDP | TCP_UDP | GENEVE | QUIC | TCP_QUIC`   
Required: No

 ** HealthCheckTimeoutSeconds **   
The amount of time, in seconds, during which no response from a target means a failed health check. The range is 2–120 seconds. For target groups with a protocol of HTTP, the default is 6 seconds. For target groups with a protocol of TCP, TLS or HTTPS, the default is 10 seconds. For target groups with a protocol of GENEVE, the default is 5 seconds. If the target type is `lambda`, the default is 30 seconds.  
Type: Integer  
Valid Range: Minimum value of 2. Maximum value of 120.  
Required: No

 ** HealthyThresholdCount **   
The number of consecutive health check successes required before considering a target healthy. The range is 2-10. If the target group protocol is TCP, TCP\$1UDP, UDP, TLS, HTTP or HTTPS, the default is 5. For target groups with a protocol of GENEVE, the default is 5. If the target type is `lambda`, the default is 5.  
Type: Integer  
Valid Range: Minimum value of 2. Maximum value of 10.  
Required: No

 ** IpAddressType **   
The IP address type. The default value is `ipv4`.  
Type: String  
Valid Values: `ipv4 | ipv6`   
Required: No

 ** Matcher **   
[HTTP/HTTPS health checks] The HTTP or gRPC codes to use when checking for a successful response from a target. For target groups with a protocol of TCP, TCP\$1UDP, UDP, QUIC, TCP\$1QUIC, or TLS the range is 200-599. For target groups with a protocol of HTTP or HTTPS, the range is 200-499. For target groups with a protocol of GENEVE, the range is 200-399.  
Type: [Matcher](API_Matcher.md) object  
Required: No

 ** Name **   
The name of the target group.  
This name must be unique per region per account, can have a maximum of 32 characters, must contain only alphanumeric characters or hyphens, and must not begin or end with a hyphen.  
Type: String  
Required: Yes

 ** Port **   
The port on which the targets receive traffic. This port is used unless you specify a port override when registering the target. If the target is a Lambda function, this parameter does not apply. If the protocol is GENEVE, the supported port is 6081.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 65535.  
Required: No

 ** Protocol **   
The protocol to use for routing traffic to the targets. For Application Load Balancers, the supported protocols are HTTP and HTTPS. For Network Load Balancers, the supported protocols are TCP, TLS, UDP, TCP\$1UDP, QUIC, or TCP\$1QUIC. For Gateway Load Balancers, the supported protocol is GENEVE. A TCP\$1UDP listener must be associated with a TCP\$1UDP target group. A TCP\$1QUIC listener must be associated with a TCP\$1QUIC target group. If the target is a Lambda function, this parameter does not apply.  
Type: String  
Valid Values: `HTTP | HTTPS | TCP | TLS | UDP | TCP_UDP | GENEVE | QUIC | TCP_QUIC`   
Required: No

 ** ProtocolVersion **   
[HTTP/HTTPS protocol] The protocol version. Specify `GRPC` to send requests to targets using gRPC. Specify `HTTP2` to send requests to targets using HTTP/2. The default is `HTTP1`, which sends requests to targets using HTTP/1.1.  
Type: String  
Required: No

 **Tags.member.N**   
The tags to assign to the target group.  
Type: Array of [Tag](API_Tag.md) objects  
Array Members: Minimum number of 1 item.  
Required: No

 ** TargetControlPort **   
The port on which the target control agent and application load balancer exchange management traffic for the target optimizer feature.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 65535.  
Required: No

 ** TargetType **   
The type of target that you must specify when registering targets with this target group. You can't specify targets for a target group using more than one target type.  
+  `instance` - Register targets by instance ID. This is the default value.
+  `ip` - Register targets by IP address. You can specify IP addresses from the subnets of the virtual private cloud (VPC) for the target group, the RFC 1918 range (10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16), and the RFC 6598 range (100.64.0.0/10). You can't specify publicly routable IP addresses.
+  `lambda` - Register a single Lambda function as a target.
+  `alb` - Register a single Application Load Balancer as a target.
Type: String  
Valid Values: `instance | ip | lambda | alb`   
Required: No

 ** UnhealthyThresholdCount **   
The number of consecutive health check failures required before considering a target unhealthy. The range is 2-10. If the target group protocol is TCP, TCP\$1UDP, UDP, TLS, QUIC, TCP\$1QUIC, HTTP or HTTPS, the default is 2. For target groups with a protocol of GENEVE, the default is 2. If the target type is `lambda`, the default is 5.  
Type: Integer  
Valid Range: Minimum value of 2. Maximum value of 10.  
Required: No

 ** VpcId **   
The identifier of the virtual private cloud (VPC). If the target is a Lambda function, this parameter does not apply. Otherwise, this parameter is required.  
Type: String  
Required: No

## Response Elements
<a name="API_CreateTargetGroup_ResponseElements"></a>

The following element is returned by the service.

 **TargetGroups.member.N**   
Information about the target group.  
Type: Array of [TargetGroup](API_TargetGroup.md) objects

## Errors
<a name="API_CreateTargetGroup_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DuplicateTargetGroupName **   
A target group with the specified name already exists.  
HTTP Status Code: 400

 ** InvalidConfigurationRequest **   
The requested configuration is not valid.  
HTTP Status Code: 400

 ** TooManyTags **   
You've reached the limit on the number of tags for this resource.  
HTTP Status Code: 400

 ** TooManyTargetGroups **   
You've reached the limit on the number of target groups for your AWS account.  
HTTP Status Code: 400

## Examples
<a name="API_CreateTargetGroup_Examples"></a>

### Create a target group to route traffic to instances registered by instance ID
<a name="API_CreateTargetGroup_Example_1"></a>

This example creates a target group for an Application Load Balancer that you can use to route traffic to instances using HTTP on port 80. You register the instances by instance ID. This target group uses the default health check settings.

#### Sample Request
<a name="API_CreateTargetGroup_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateTargetGroup
&Name=my-targets
&Protocol=HTTP
&Port=80
&VpcId=vpc-3ac0fb5f
&TargetType=instance
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_CreateTargetGroup_Example_1_Response"></a>

```
<CreateTargetGroupResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <CreateTargetGroupResult> 
    <TargetGroups> 
      <member> 
        <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067</TargetGroupArn> 
        <HealthCheckTimeoutSeconds>5</HealthCheckTimeoutSeconds> 
        <HealthCheckPort>traffic-port</HealthCheckPort> 
        <Matcher>
          <HttpCode>200</HttpCode> 
        </Matcher> 
        <TargetGroupName>my-targets</TargetGroupName> 
        <HealthCheckProtocol>HTTP</HealthCheckProtocol> 
        <HealthCheckPath>/</HealthCheckPath> 
        <Protocol>HTTP</Protocol> 
        <Port>80</Port> 
        <VpcId>vpc-3ac0fb5f</VpcId> 
        <HealthyThresholdCount>5</HealthyThresholdCount> 
        <HealthCheckIntervalSeconds>30</HealthCheckIntervalSeconds> 
        <UnhealthyThresholdCount>2</UnhealthyThresholdCount> 
      </member> 
    </TargetGroups> 
  </CreateTargetGroupResult> 
  <ResponseMetadata> 
    <RequestId>b83fe90e-f2d5-11e5-b95d-3b2c1831fc26</RequestId> 
  </ResponseMetadata>
</CreateTargetGroupResponse>
```

### Create a target group to route traffic to IP addresses
<a name="API_CreateTargetGroup_Example_2"></a>

This example creates a target group for a Network Load Balancer that you can use to route traffic to IP addresses using TCP on port 80. This target group uses the default health check settings.

#### Sample Request
<a name="API_CreateTargetGroup_Example_2_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateTargetGroup
&Name=my-ip-targets
&Protocol=TCP
&Port=80
&VpcId=vpc-09e5e2c5ef7e38ae7
&TargetType=ip
&Version=2015-12-01
&AUTHPARAMS
```

### Create a target group to route traffic to a Lambda function
<a name="API_CreateTargetGroup_Example_3"></a>

This example creates a target group for an Application Load Balancer that you can use to route traffic to a Lambda function. This target group uses the default health check settings. For more information, see [Lambda functions as targets](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/lambda-functions.html) in the *Application Load Balancers Guide*.

#### Sample Request
<a name="API_CreateTargetGroup_Example_3_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateTargetGroup
&Name=my-lambda-target
&TargetType=lambda
&Version=2015-12-01
&AUTHPARAMS
```

### Create a target group for your Gateway Load Balancer
<a name="API_CreateTargetGroup_Example_4"></a>

This example creates a target group for a Gateway Load Balancer. The protocol must be GENEVE and the port must be 6081.

#### Sample Request
<a name="API_CreateTargetGroup_Example_4_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateTargetGroup
&Name=my-appliance-targets
&Protocol=GENEVE
&Port=6081
&VpcId=vpc-09e5e2c5ef7e38ae7
&TargetType=ip
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_CreateTargetGroup_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/CreateTargetGroup) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/CreateTargetGroup) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/CreateTargetGroup) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/CreateTargetGroup) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/CreateTargetGroup) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/CreateTargetGroup) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/CreateTargetGroup) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/CreateTargetGroup) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/CreateTargetGroup) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/CreateTargetGroup) 

# CreateTrustStore
<a name="API_CreateTrustStore"></a>

Creates a trust store.

For more information, see [Mutual TLS for Application Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/mutual-authentication.html).

## Request Parameters
<a name="API_CreateTrustStore_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** CaCertificatesBundleS3Bucket **   
The Amazon S3 bucket for the ca certificates bundle.  
Type: String  
Required: Yes

 ** CaCertificatesBundleS3Key **   
The Amazon S3 path for the ca certificates bundle.  
Type: String  
Required: Yes

 ** CaCertificatesBundleS3ObjectVersion **   
The Amazon S3 object version for the ca certificates bundle. If undefined the current version is used.  
Type: String  
Required: No

 ** Name **   
The name of the trust store.  
This name must be unique per region and can't be changed after creation.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 32.  
Pattern: `^([a-zA-Z0-9]+-)*[a-zA-Z0-9]+$`   
Required: Yes

 **Tags.member.N**   
The tags to assign to the trust store.  
Type: Array of [Tag](API_Tag.md) objects  
Array Members: Minimum number of 1 item.  
Required: No

## Response Elements
<a name="API_CreateTrustStore_ResponseElements"></a>

The following element is returned by the service.

 **TrustStores.member.N**   
Information about the trust store created.  
Type: Array of [TrustStore](API_TrustStore.md) objects

## Errors
<a name="API_CreateTrustStore_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** CaCertificatesBundleNotFound **   
The specified ca certificate bundle does not exist.  
HTTP Status Code: 400

 ** DuplicateTagKeys **   
A tag key was specified more than once.  
HTTP Status Code: 400

 ** DuplicateTrustStoreName **   
A trust store with the specified name already exists.  
HTTP Status Code: 400

 ** InvalidCaCertificatesBundle **   
The specified ca certificate bundle is in an invalid format, or corrupt.  
HTTP Status Code: 400

 ** TooManyTags **   
You've reached the limit on the number of tags for this resource.  
HTTP Status Code: 400

 ** TooManyTrustStores **   
You've reached the limit on the number of trust stores for your AWS account.  
HTTP Status Code: 400

## Examples
<a name="API_CreateTrustStore_Examples"></a>

### Create a trust store.
<a name="API_CreateTrustStore_Example_1"></a>

This example creates a trust store using the current version of the specified ca certificate bundle.

#### Sample Request
<a name="API_CreateTrustStore_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=CreateTrustStore
&Name=my-trust-store
&CaCertificatesBundleS3Bucket=amzn-s3-demo-bucket
&CaCertificatesBundleS3Key=CACertBundle.pem
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_CreateTrustStore_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/CreateTrustStore) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/CreateTrustStore) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/CreateTrustStore) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/CreateTrustStore) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/CreateTrustStore) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/CreateTrustStore) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/CreateTrustStore) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/CreateTrustStore) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/CreateTrustStore) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/CreateTrustStore) 

# DeleteListener
<a name="API_DeleteListener"></a>

Deletes the specified listener.

Alternatively, your listener is deleted when you delete the load balancer to which it is attached, using [DeleteLoadBalancer](API_DeleteLoadBalancer.md).

## Request Parameters
<a name="API_DeleteListener_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** ListenerArn **   
The Amazon Resource Name (ARN) of the listener.  
Type: String  
Required: Yes

## Errors
<a name="API_DeleteListener_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ListenerNotFound **   
The specified listener does not exist.  
HTTP Status Code: 400

 ** ResourceInUse **   
A specified resource is in use.  
HTTP Status Code: 400

## Examples
<a name="API_DeleteListener_Examples"></a>

### Delete a listener
<a name="API_DeleteListener_Example_1"></a>

This example deletes the specified listener.

#### Sample Request
<a name="API_DeleteListener_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DeleteListener
&ListenerArn=arn:aws:elasticloadbalancing:ua-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_DeleteListener_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DeleteListener) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DeleteListener) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DeleteListener) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DeleteListener) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DeleteListener) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DeleteListener) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DeleteListener) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DeleteListener) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DeleteListener) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DeleteListener) 

# DeleteLoadBalancer
<a name="API_DeleteLoadBalancer"></a>

Deletes the specified Application Load Balancer, Network Load Balancer, or Gateway Load Balancer. Deleting a load balancer also deletes its listeners.

You can't delete a load balancer if deletion protection is enabled. If the load balancer does not exist or has already been deleted, the call succeeds.

Deleting a load balancer does not affect its registered targets. For example, your EC2 instances continue to run and are still registered to their target groups. If you no longer need these EC2 instances, you can stop or terminate them.

## Request Parameters
<a name="API_DeleteLoadBalancer_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** LoadBalancerArn **   
The Amazon Resource Name (ARN) of the load balancer.  
Type: String  
Required: Yes

## Errors
<a name="API_DeleteLoadBalancer_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

 ** OperationNotPermitted **   
This operation is not allowed.  
HTTP Status Code: 400

 ** ResourceInUse **   
A specified resource is in use.  
HTTP Status Code: 400

## Examples
<a name="API_DeleteLoadBalancer_Examples"></a>

### Delete a load balancer
<a name="API_DeleteLoadBalancer_Example_1"></a>

This example deletes the specified load balancer.

#### Sample Request
<a name="API_DeleteLoadBalancer_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DeleteLoadBalancer
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_DeleteLoadBalancer_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DeleteLoadBalancer) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DeleteLoadBalancer) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DeleteLoadBalancer) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DeleteLoadBalancer) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DeleteLoadBalancer) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DeleteLoadBalancer) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DeleteLoadBalancer) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DeleteLoadBalancer) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DeleteLoadBalancer) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DeleteLoadBalancer) 

# DeleteRule
<a name="API_DeleteRule"></a>

Deletes the specified rule.

You can't delete the default rule.

## Request Parameters
<a name="API_DeleteRule_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** RuleArn **   
The Amazon Resource Name (ARN) of the rule.  
Type: String  
Required: Yes

## Errors
<a name="API_DeleteRule_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** OperationNotPermitted **   
This operation is not allowed.  
HTTP Status Code: 400

 ** RuleNotFound **   
The specified rule does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_DeleteRule_Examples"></a>

### Delete a rule
<a name="API_DeleteRule_Example_1"></a>

This example deletes the specified rule.

#### Sample Request
<a name="API_DeleteRule_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DeleteRule
&RuleArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_DeleteRule_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DeleteRule) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DeleteRule) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DeleteRule) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DeleteRule) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DeleteRule) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DeleteRule) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DeleteRule) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DeleteRule) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DeleteRule) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DeleteRule) 

# DeleteSharedTrustStoreAssociation
<a name="API_DeleteSharedTrustStoreAssociation"></a>

Deletes a shared trust store association.

## Request Parameters
<a name="API_DeleteSharedTrustStoreAssociation_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** ResourceArn **   
The Amazon Resource Name (ARN) of the resource.  
Type: String  
Required: Yes

 ** TrustStoreArn **   
The Amazon Resource Name (ARN) of the trust store.  
Type: String  
Required: Yes

## Errors
<a name="API_DeleteSharedTrustStoreAssociation_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AssociationNotFound **   
The specified association does not exist.  
HTTP Status Code: 400

 ** DeleteAssociationSameAccount **   
The specified association can't be within the same account.  
HTTP Status Code: 400

 ** TrustStoreNotFound **   
The specified trust store does not exist.  
HTTP Status Code: 400

## See Also
<a name="API_DeleteSharedTrustStoreAssociation_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DeleteSharedTrustStoreAssociation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DeleteSharedTrustStoreAssociation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DeleteSharedTrustStoreAssociation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DeleteSharedTrustStoreAssociation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DeleteSharedTrustStoreAssociation) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DeleteSharedTrustStoreAssociation) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DeleteSharedTrustStoreAssociation) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DeleteSharedTrustStoreAssociation) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DeleteSharedTrustStoreAssociation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DeleteSharedTrustStoreAssociation) 

# DeleteTargetGroup
<a name="API_DeleteTargetGroup"></a>

Deletes the specified target group.

You can delete a target group if it is not referenced by any actions. Deleting a target group also deletes any associated health checks. Deleting a target group does not affect its registered targets. For example, any EC2 instances continue to run until you stop or terminate them.

## Request Parameters
<a name="API_DeleteTargetGroup_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** TargetGroupArn **   
The Amazon Resource Name (ARN) of the target group.  
Type: String  
Required: Yes

## Errors
<a name="API_DeleteTargetGroup_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ResourceInUse **   
A specified resource is in use.  
HTTP Status Code: 400

## Examples
<a name="API_DeleteTargetGroup_Examples"></a>

### Delete a target group
<a name="API_DeleteTargetGroup_Example_1"></a>

This example deletes the specified target group.

#### Sample Request
<a name="API_DeleteTargetGroup_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DeleteTargetGroup
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_DeleteTargetGroup_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DeleteTargetGroup) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DeleteTargetGroup) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DeleteTargetGroup) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DeleteTargetGroup) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DeleteTargetGroup) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DeleteTargetGroup) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DeleteTargetGroup) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DeleteTargetGroup) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DeleteTargetGroup) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DeleteTargetGroup) 

# DeleteTrustStore
<a name="API_DeleteTrustStore"></a>

Deletes a trust store.

## Request Parameters
<a name="API_DeleteTrustStore_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** TrustStoreArn **   
The Amazon Resource Name (ARN) of the trust store.  
Type: String  
Required: Yes

## Errors
<a name="API_DeleteTrustStore_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** TrustStoreInUse **   
The specified trust store is currently in use.  
HTTP Status Code: 400

 ** TrustStoreNotFound **   
The specified trust store does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_DeleteTrustStore_Examples"></a>

### Delete a trust store.
<a name="API_DeleteTrustStore_Example_1"></a>

This example deletes the specified trust store.

#### Sample Request
<a name="API_DeleteTrustStore_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DeleteTrustStore
&TrustStoreArn=arn:aws:elasticloadbalancing:us-east-1:111122223333:truststore/my-trust-store/3ym756xh7yj
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_DeleteTrustStore_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DeleteTrustStore) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DeleteTrustStore) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DeleteTrustStore) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DeleteTrustStore) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DeleteTrustStore) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DeleteTrustStore) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DeleteTrustStore) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DeleteTrustStore) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DeleteTrustStore) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DeleteTrustStore) 

# DeregisterTargets
<a name="API_DeregisterTargets"></a>

Deregisters the specified targets from the specified target group. After the targets are deregistered, they no longer receive traffic from the load balancer.

The load balancer stops sending requests to targets that are deregistering, but uses connection draining to ensure that in-flight traffic completes on the existing connections. This deregistration delay is configured by default but can be updated for each target group.

For more information, see the following:
+  [ Deregistration delay](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/edit-target-group-attributes.html#deregistration-delay) in the *Application Load Balancers User Guide* 
+  [ Deregistration delay](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/edit-target-group-attributes.html#deregistration-delay) in the *Network Load Balancers User Guide* 
+  [ Deregistration delay](https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/edit-target-group-attributes.html#deregistration-delay) in the *Gateway Load Balancers User Guide* 

Note: If the specified target does not exist, the action returns successfully.

## Request Parameters
<a name="API_DeregisterTargets_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** TargetGroupArn **   
The Amazon Resource Name (ARN) of the target group.  
Type: String  
Required: Yes

 **Targets.member.N**   
The targets. If you specified a port override when you registered a target, you must specify both the target ID and the port when you deregister it.  
Type: Array of [TargetDescription](API_TargetDescription.md) objects  
Required: Yes

## Errors
<a name="API_DeregisterTargets_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidTarget **   
The specified target does not exist, is not in the same VPC as the target group, or has an unsupported instance type.  
HTTP Status Code: 400

 ** TargetGroupNotFound **   
The specified target group does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_DeregisterTargets_Examples"></a>

### Deregister an instance from a target group
<a name="API_DeregisterTargets_Example_1"></a>

This example deregisters the specified instance from the specified target group.

#### Sample Request
<a name="API_DeregisterTargets_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DeregisterTargets
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Targets.member.1.Id=i-0f76fade435676abd
&Version=2015-12-01
&AUTHPARAMS
```

### Deregister an IP address from a target group
<a name="API_DeregisterTargets_Example_2"></a>

This example deregisters the specified IP address from the specified target group.

#### Sample Request
<a name="API_DeregisterTargets_Example_2_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DeregisterTargets
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Targets.member.1.Id=10.0.1.238
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_DeregisterTargets_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DeregisterTargets) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DeregisterTargets) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DeregisterTargets) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DeregisterTargets) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DeregisterTargets) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DeregisterTargets) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DeregisterTargets) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DeregisterTargets) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DeregisterTargets) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DeregisterTargets) 

# DescribeAccountLimits
<a name="API_DescribeAccountLimits"></a>

Describes the current Elastic Load Balancing resource limits for your AWS account.

For more information, see the following:
+  [Quotas for your Application Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-limits.html) 
+  [Quotas for your Network Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-limits.html) 
+  [Quotas for your Gateway Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/quotas-limits.html) 

## Request Parameters
<a name="API_DescribeAccountLimits_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** Marker **   
The marker for the next set of results. (You received this marker from a previous call.)  
Type: String  
Required: No

 ** PageSize **   
The maximum number of results to return with this call.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 400.  
Required: No

## Response Elements
<a name="API_DescribeAccountLimits_ResponseElements"></a>

The following elements are returned by the service.

 **Limits.member.N**   
Information about the limits.  
Type: Array of [Limit](API_Limit.md) objects

 ** NextMarker **   
If there are additional results, this is the marker for the next set of results. Otherwise, this is null.  
Type: String

## Errors
<a name="API_DescribeAccountLimits_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

## See Also
<a name="API_DescribeAccountLimits_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeAccountLimits) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeAccountLimits) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeAccountLimits) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeAccountLimits) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeAccountLimits) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeAccountLimits) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeAccountLimits) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeAccountLimits) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeAccountLimits) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeAccountLimits) 

# DescribeCapacityReservation
<a name="API_DescribeCapacityReservation"></a>

Describes the capacity reservation status for the specified load balancer.

## Request Parameters
<a name="API_DescribeCapacityReservation_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** LoadBalancerArn **   
The Amazon Resource Name (ARN) of the load balancer.  
Type: String  
Required: Yes

## Response Elements
<a name="API_DescribeCapacityReservation_ResponseElements"></a>

The following elements are returned by the service.

 **CapacityReservationState.member.N**   
The state of the capacity reservation.  
Type: Array of [ZonalCapacityReservationState](API_ZonalCapacityReservationState.md) objects

 ** DecreaseRequestsRemaining **   
The amount of daily capacity decreases remaining.  
Type: Integer

 ** LastModifiedTime **   
The last time the capacity reservation was modified.  
Type: Timestamp

 ** MinimumLoadBalancerCapacity **   
The requested minimum capacity reservation for the load balancer  
Type: [MinimumLoadBalancerCapacity](API_MinimumLoadBalancerCapacity.md) object

## Errors
<a name="API_DescribeCapacityReservation_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

## See Also
<a name="API_DescribeCapacityReservation_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeCapacityReservation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeCapacityReservation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeCapacityReservation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeCapacityReservation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeCapacityReservation) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeCapacityReservation) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeCapacityReservation) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeCapacityReservation) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeCapacityReservation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeCapacityReservation) 

# DescribeListenerAttributes
<a name="API_DescribeListenerAttributes"></a>

Describes the attributes for the specified listener.

## Request Parameters
<a name="API_DescribeListenerAttributes_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** ListenerArn **   
The Amazon Resource Name (ARN) of the listener.  
Type: String  
Required: Yes

## Response Elements
<a name="API_DescribeListenerAttributes_ResponseElements"></a>

The following element is returned by the service.

 **Attributes.member.N**   
Information about the listener attributes.  
Type: Array of [ListenerAttribute](API_ListenerAttribute.md) objects

## Errors
<a name="API_DescribeListenerAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ListenerNotFound **   
The specified listener does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeListenerAttributes_Examples"></a>

### Describe listener attributes
<a name="API_DescribeListenerAttributes_Example_1"></a>

This example describes the attributes of the specified listener.

#### Sample Request
<a name="API_DescribeListenerAttributes_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeListenerAttributes
&ListenerArn=arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/net/my-listener/73e2d6bc24d8a067/d5dc06411fa5bcea
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_DescribeListenerAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeListenerAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeListenerAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeListenerAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeListenerAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeListenerAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeListenerAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeListenerAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeListenerAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeListenerAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeListenerAttributes) 

# DescribeListenerCertificates
<a name="API_DescribeListenerCertificates"></a>

Describes the default certificate and the certificate list for the specified HTTPS or TLS listener.

If the default certificate is also in the certificate list, it appears twice in the results (once with `IsDefault` set to true and once with `IsDefault` set to false).

For more information, see [SSL certificates](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/https-listener-certificates.html) in the *Application Load Balancers Guide* or [Server certificates](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/tls-listener-certificates.html) in the *Network Load Balancers Guide*.

## Request Parameters
<a name="API_DescribeListenerCertificates_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** ListenerArn **   
The Amazon Resource Names (ARN) of the listener.  
Type: String  
Required: Yes

 ** Marker **   
The marker for the next set of results. (You received this marker from a previous call.)  
Type: String  
Required: No

 ** PageSize **   
The maximum number of results to return with this call.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 400.  
Required: No

## Response Elements
<a name="API_DescribeListenerCertificates_ResponseElements"></a>

The following elements are returned by the service.

 **Certificates.member.N**   
Information about the certificates.  
Type: Array of [Certificate](API_Certificate.md) objects

 ** NextMarker **   
If there are additional results, this is the marker for the next set of results. Otherwise, this is null.  
Type: String

## Errors
<a name="API_DescribeListenerCertificates_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ListenerNotFound **   
The specified listener does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeListenerCertificates_Examples"></a>

### Describe the certificate list for a listener
<a name="API_DescribeListenerCertificates_Example_1"></a>

This example describes the certificate list for the specified listener.

#### Sample Request
<a name="API_DescribeListenerCertificates_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeListenerCertificates
&ListenerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_DescribeListenerCertificates_Example_1_Response"></a>

```
<DescribeListenerCertificatesResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <DescribeListenerCertificatesResult> 
    <Certificates> 
      <member> 
        <CertificateArn>arn:aws:acm:us-west-2:123456789012:certificate/1bf70a25-6914-495a-92f8-e27feEXAMPLE</CertificateArn>
        <IsDefault>true</IsDefault> 
      </member> 
      <member> 
        <CertificateArn>arn:aws:acm:us-west-2:123456789012:certificate/68c11a12-39de-44dd-b329-fe64aEXAMPLE</CertificateArn>
        <IsDefault>false</IsDefault> 
      </member> 
      <member> 
        <CertificateArn>arn:aws:acm:us-west-2:123456789012:certificate/1bf70a25-6914-495a-92f8-e27feEXAMPLE</CertificateArn>
        <IsDefault>false</IsDefault> 
      </member> 
    </Certificates> 
  </DescribeListenerCertificatesResult> 
  <ResponseMetadata> 
    <RequestId>18e470d3-f39c-11e5-a53c-67205c0d10fd</RequestId> 
  </ResponseMetadata>
</DescribeListenerCertificatesResponse>
```

## See Also
<a name="API_DescribeListenerCertificates_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeListenerCertificates) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeListenerCertificates) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeListenerCertificates) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeListenerCertificates) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeListenerCertificates) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeListenerCertificates) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeListenerCertificates) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeListenerCertificates) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeListenerCertificates) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeListenerCertificates) 

# DescribeListeners
<a name="API_DescribeListeners"></a>

Describes the specified listeners or the listeners for the specified Application Load Balancer, Network Load Balancer, or Gateway Load Balancer. You must specify either a load balancer or one or more listeners.

For an HTTPS or TLS listener, the output includes the default certificate for the listener. To describe the certificate list for the listener, use [DescribeListenerCertificates](API_DescribeListenerCertificates.md).

## Request Parameters
<a name="API_DescribeListeners_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **ListenerArns.member.N**   
The Amazon Resource Names (ARN) of the listeners.  
Type: Array of strings  
Required: No

 ** LoadBalancerArn **   
The Amazon Resource Name (ARN) of the load balancer.  
Type: String  
Required: No

 ** Marker **   
The marker for the next set of results. (You received this marker from a previous call.)  
Type: String  
Required: No

 ** PageSize **   
The maximum number of results to return with this call.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 400.  
Required: No

## Response Elements
<a name="API_DescribeListeners_ResponseElements"></a>

The following elements are returned by the service.

 **Listeners.member.N**   
Information about the listeners.  
Type: Array of [Listener](API_Listener.md) objects

 ** NextMarker **   
If there are additional results, this is the marker for the next set of results. Otherwise, this is null.  
Type: String

## Errors
<a name="API_DescribeListeners_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ListenerNotFound **   
The specified listener does not exist.  
HTTP Status Code: 400

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

 ** UnsupportedProtocol **   
The specified protocol is not supported.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeListeners_Examples"></a>

### Describe an HTTP listener
<a name="API_DescribeListeners_Example_1"></a>

This example describes the specified HTTP listener.

#### Sample Request
<a name="API_DescribeListeners_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeListeners
&ListenerArns.member.1=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_DescribeListeners_Example_1_Response"></a>

```
<DescribeListenersResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <DescribeListenersResult> 
    <Listeners> 
      <member> 
        <LoadBalancerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188</LoadBalancerArn> 
        <Protocol>HTTP</Protocol> 
        <Port>80</Port> 
        <ListenerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2</ListenerArn> 
        <DefaultActions> 
          <member> 
            <Type>forward</Type> 
            <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067</TargetGroupArn> 
          </member> 
        </DefaultActions> 
      </member> 
    </Listeners> 
  </DescribeListenersResult> 
  <ResponseMetadata> 
    <RequestId>18e470d3-f39c-11e5-a53c-67205c0d10fd</RequestId> 
  </ResponseMetadata>
</DescribeListenersResponse>
```

### Describe an HTTPS listener
<a name="API_DescribeListeners_Example_2"></a>

This example describes the specified HTTPS listener.

#### Sample Request
<a name="API_DescribeListeners_Example_2_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeListeners
&ListenerArns.member.1=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_DescribeListeners_Example_2_Response"></a>

```
<DescribeListenersResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <DescribeListenersResult> 
    <Listeners> 
      <member> 
        <Port>443</Port> 
        <Protocol>HTTPS</Protocol> 
        <LoadBalancerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188</LoadBalancerArn> 
        <ListenerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2</ListenerArn> 
        <DefaultActions> 
          <member> 
            <Type>forward</Type> 
            <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067</TargetGroupArn> 
          </member> 
        </DefaultActions>
        <SslPolicy>ELBSecurityPolicy-2016-08</SslPolicy>
        <Certificates>
          <member> 
            <CertificateArn>arn:aws:acm:us-west-2:123456789012:certificate/68c11a12-39de-44dd-b329-fe64aEXAMPLE</CertificateArn>
          </member> 
        </Certificates>
      </member> 
    </Listeners> 
  </DescribeListenersResult> 
  <ResponseMetadata> 
    <RequestId>18e470d3-f39c-11e5-a53c-67205c0d10fd</RequestId> 
  </ResponseMetadata>
</DescribeListenersResponse>
```

### Describe the listeners for a load balancer
<a name="API_DescribeListeners_Example_3"></a>

This example describe the listeners for the specified load balancer.

#### Sample Request
<a name="API_DescribeListeners_Example_3_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeListeners
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_DescribeListeners_Example_3_Response"></a>

```
<DescribeLoadBalancersResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <DescribeListenersResult> 
    <Listeners> 
      <member> 
        <LoadBalancerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188</LoadBalancerArn> 
        <Protocol>HTTPS</Protocol> 
        <Certificates> 
          <member> 
            <CertificateArn>arn:aws:iam::123456789012:server-certificate/my-server-cert</CertificateArn> 
          </member> 
        </Certificates> 
        <Port>443</Port> 
        <SslPolicy>ELBSecurityPolicy-2016-08</SslPolicy> 
        <ListenerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65</ListenerArn> 
        <DefaultActions> 
          <member> 
            <Type>forward</Type> 
            <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067</TargetGroupArn> 
          </member> 
        </DefaultActions> 
      </member> 
      <member> 
        <LoadBalancerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188</LoadBalancerArn> 
        <Protocol>HTTP</Protocol> 
        <Port>80</Port> 
        <ListenerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2</ListenerArn> 
        <DefaultActions> 
          <member> 
            <Type>forward</Type> 
            <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067</TargetGroupArn> 
          </member> 
        </DefaultActions> 
      </member> 
    </Listeners> 
  </DescribeListenersResult> 
  <ResponseMetadata> 
    <RequestId>65a3a7ea-f39c-11e5-b543-9f2c3fbb9bee</RequestId> 
  </ResponseMetadata>
</DescribeLoadBalancersResponse>
```

## See Also
<a name="API_DescribeListeners_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeListeners) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeListeners) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeListeners) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeListeners) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeListeners) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeListeners) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeListeners) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeListeners) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeListeners) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeListeners) 

# DescribeLoadBalancerAttributes
<a name="API_DescribeLoadBalancerAttributes"></a>

Describes the attributes for the specified Application Load Balancer, Network Load Balancer, or Gateway Load Balancer.

For more information, see the following:
+  [Load balancer attributes](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/application-load-balancers.html#load-balancer-attributes) in the *Application Load Balancers Guide* 
+  [Load balancer attributes](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancers.html#load-balancer-attributes) in the *Network Load Balancers Guide* 
+  [Load balancer attributes](https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/gateway-load-balancers.html#load-balancer-attributes) in the *Gateway Load Balancers Guide* 

## Request Parameters
<a name="API_DescribeLoadBalancerAttributes_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** LoadBalancerArn **   
The Amazon Resource Name (ARN) of the load balancer.  
Type: String  
Required: Yes

## Response Elements
<a name="API_DescribeLoadBalancerAttributes_ResponseElements"></a>

The following element is returned by the service.

 **Attributes.member.N**   
Information about the load balancer attributes.  
Type: Array of [LoadBalancerAttribute](API_LoadBalancerAttribute.md) objects  
Array Members: Maximum number of 20 items.

## Errors
<a name="API_DescribeLoadBalancerAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeLoadBalancerAttributes_Examples"></a>

### Describe load balancer attributes
<a name="API_DescribeLoadBalancerAttributes_Example_1"></a>

This example describes the attributes of the specified load balancer.

#### Sample Request
<a name="API_DescribeLoadBalancerAttributes_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeLoadBalancerAttributes
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_DescribeLoadBalancerAttributes_Example_1_Response"></a>

```
<DescribeLoadBalancerAttributesResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <DescribeLoadBalancerAttributesResult> 
    <Attributes> 
      <member> 
        <Value>false</Value> 
        <Key>access_logs.s3.enabled</Key> 
      </member> 
      <member> 
        <Value>60</Value> 
        <Key>idle_timeout.timeout_seconds</Key> 
      </member> 
      <member> 
        <Value /> 
        <Key>access_logs.s3.prefix</Key> 
      </member> 
      <member> 
        <Value>false</Value> 
        <Key>deletion_protection.enabled</Key> 
      </member> 
      <member> 
        <Value /> 
        <Key>access_logs.s3.bucket</Key> 
      </member> 
    </Attributes> 
  </DescribeLoadBalancerAttributesResult> 
  <ResponseMetadata> 
    <RequestId>1528a9a4-f38e-11e5-8ead-f1e91be31786</RequestId> 
  </ResponseMetadata>
</DescribeLoadBalancerAttributesResponse>
```

## See Also
<a name="API_DescribeLoadBalancerAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancerAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancerAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancerAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancerAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancerAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancerAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancerAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancerAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancerAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancerAttributes) 

# DescribeLoadBalancers
<a name="API_DescribeLoadBalancers"></a>

Describes the specified load balancers or all of your load balancers.

To describe the listeners for a load balancer, use [DescribeListeners](API_DescribeListeners.md). To describe the attributes for a load balancer, use [DescribeLoadBalancerAttributes](API_DescribeLoadBalancerAttributes.md).

## Request Parameters
<a name="API_DescribeLoadBalancers_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **LoadBalancerArns.member.N**   
The Amazon Resource Names (ARN) of the load balancers. You can specify up to 20 load balancers in a single call.  
Type: Array of strings  
Required: No

 ** Marker **   
The marker for the next set of results. (You received this marker from a previous call.)  
Type: String  
Required: No

 **Names.member.N**   
The names of the load balancers.  
Type: Array of strings  
Required: No

 ** PageSize **   
The maximum number of results to return with this call.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 400.  
Required: No

## Response Elements
<a name="API_DescribeLoadBalancers_ResponseElements"></a>

The following elements are returned by the service.

 **LoadBalancers.member.N**   
Information about the load balancers.  
Type: Array of [LoadBalancer](API_LoadBalancer.md) objects

 ** NextMarker **   
If there are additional results, this is the marker for the next set of results. Otherwise, this is null.  
Type: String

## Errors
<a name="API_DescribeLoadBalancers_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeLoadBalancers_Examples"></a>

### Describe a load balancer
<a name="API_DescribeLoadBalancers_Example_1"></a>

This example describes the specified load balancer.

#### Sample Request
<a name="API_DescribeLoadBalancers_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeLoadBalancers
&LoadBalancerArns.member.1=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_DescribeLoadBalancers_Example_1_Response"></a>

```
<DescribeLoadBalancersResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <DescribeLoadBalancersResult>
    <LoadBalancers> 
      <member> 
        <LoadBalancerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188</LoadBalancerArn> 
        <Scheme>internet-facing</Scheme> 
        <LoadBalancerName>my-load-balancer</LoadBalancerName> 
        <VpcId>vpc-3ac0fb5f</VpcId> 
        <CanonicalHostedZoneId>Z2P70J7EXAMPLE</CanonicalHostedZoneId> 
        <CreatedTime>2016-03-25T21:26:12.920Z</CreatedTime> 
        <AvailabilityZones> 
          <member> 
            <SubnetId>subnet-8360a9e7</SubnetId> 
            <ZoneName>us-west-2a</ZoneName> 
          </member> 
          <member> 
            <SubnetId>subnet-b7d581c0</SubnetId> 
            <ZoneName>us-west-2b</ZoneName> 
          </member> 
        </AvailabilityZones> 
        <SecurityGroups> 
          <member>sg-5943793c</member> 
        </SecurityGroups> 
        <DNSName>my-load-balancer-424835706.us-west-2.elb.amazonaws.com</DNSName> 
        <State> 
          <Code>active</Code> 
        </State> 
        <Type>application</Type> 
      </member> 
    </LoadBalancers> 
  </DescribeLoadBalancersResult> 
  <ResponseMetadata> 
    <RequestId>6581c0ac-f39f-11e5-bb98-57195a6eb84a</RequestId> 
  </ResponseMetadata>
</DescribeLoadBalancersResponse>
```

### Describe all load balancers
<a name="API_DescribeLoadBalancers_Example_2"></a>

This example describes all of your load balancers.

#### Sample Request
<a name="API_DescribeLoadBalancers_Example_2_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeLoadBalancers
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_DescribeLoadBalancers_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancers) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancers) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancers) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancers) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancers) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancers) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancers) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancers) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancers) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeLoadBalancers) 

# DescribeRules
<a name="API_DescribeRules"></a>

Describes the specified rules or the rules for the specified listener. You must specify either a listener or rules.

## Request Parameters
<a name="API_DescribeRules_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** ListenerArn **   
The Amazon Resource Name (ARN) of the listener.  
Type: String  
Required: No

 ** Marker **   
The marker for the next set of results. (You received this marker from a previous call.)  
Type: String  
Required: No

 ** PageSize **   
The maximum number of results to return with this call.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 400.  
Required: No

 **RuleArns.member.N**   
The Amazon Resource Names (ARN) of the rules.  
Type: Array of strings  
Required: No

## Response Elements
<a name="API_DescribeRules_ResponseElements"></a>

The following elements are returned by the service.

 ** NextMarker **   
If there are additional results, this is the marker for the next set of results. Otherwise, this is null.  
Type: String

 **Rules.member.N**   
Information about the rules.  
Type: Array of [Rule](API_Rule.md) objects

## Errors
<a name="API_DescribeRules_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ListenerNotFound **   
The specified listener does not exist.  
HTTP Status Code: 400

 ** RuleNotFound **   
The specified rule does not exist.  
HTTP Status Code: 400

 ** UnsupportedProtocol **   
The specified protocol is not supported.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeRules_Examples"></a>

### Describe a rule
<a name="API_DescribeRules_Example_1"></a>

This example describes the specified rule.

#### Sample Request
<a name="API_DescribeRules_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeRules
&RuleArns.member.1=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_DescribeRules_Example_1_Response"></a>

```
<DescribeRulesResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <DescribeRulesResult> 
    <Rules> 
      <member> 
        <IsDefault>false</IsDefault> 
        <Conditions> 
          <member> 
            <Field>path-pattern</Field> 
            <Values> 
              <member>/img/*</member> 
            </Values> 
          </member> 
        </Conditions> 
        <Priority>10</Priority> 
        <Actions> 
          <member> 
            <Type>forward</Type> 
            <TargetGroupArn>arn:aws:elasticloadbalancing:ua-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067</TargetGroupArn> 
          </member> 
        </Actions> 
        <RuleArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee</RuleArn> 
      </member> 
    </Rules> 
  </DescribeRulesResult> 
  <ResponseMetadata> 
    <RequestId>74926cf3-f3a3-11e5-b543-9f2c3fbb9bee</RequestId> 
  </ResponseMetadata>
</DescribeRulesResponse>
```

### Describe the rules for a listener
<a name="API_DescribeRules_Example_2"></a>

This example describes the rules for the specified listener. The output includes the default rule and any other rules that you've defined.

#### Sample Request
<a name="API_DescribeRules_Example_2_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeRules
&ListenerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_DescribeRules_Example_2_Response"></a>

```
<DescribeRulesResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <DescribeRulesResult> 
    <Rules> 
      <member> 
        <IsDefault>false</IsDefault> 
        <Conditions> 
          <member> 
            <Field>path-pattern</Field> 
            <Values> 
              <member>/img/*</member> 
            </Values> 
          </member> 
        </Conditions> 
        <Priority>10</Priority> 
        <Actions> 
          <member> 
            <Type>forward</Type> 
            <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067</TargetGroupArn> 
          </member> 
        </Actions> 
        <RuleArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee</RuleArn> 
      </member> 
      <member> 
        <IsDefault>true</IsDefault> 
        <Conditions /> 
        <Priority>default</Priority> 
        <Actions> 
          <member> 
            <Type>forward</Type> 
            <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067</TargetGroupArn> 
          </member> 
        </Actions> 
        <RuleArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/fd906cf3d7a9d36d</RuleArn> 
      </member> 
    </Rules> 
  </DescribeRulesResult> 
  <ResponseMetadata> 
    <RequestId>d8581c8d-f3a3-11e5-8a24-ffe2bf8623ae</RequestId> 
  </ResponseMetadata>
</DescribeRulesResponse>
```

## See Also
<a name="API_DescribeRules_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeRules) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeRules) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeRules) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeRules) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeRules) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeRules) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeRules) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeRules) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeRules) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeRules) 

# DescribeSSLPolicies
<a name="API_DescribeSSLPolicies"></a>

Describes the specified policies or all policies used for SSL negotiation.

For more information, see [Security policies](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/describe-ssl-policies.html) in the *Application Load Balancers Guide* and [Security policies](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/describe-ssl-policies.html) in the *Network Load Balancers Guide*.

## Request Parameters
<a name="API_DescribeSSLPolicies_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** LoadBalancerType **   
 The type of load balancer. The default lists the SSL policies for all load balancers.  
Type: String  
Valid Values: `application | network | gateway`   
Required: No

 ** Marker **   
The marker for the next set of results. (You received this marker from a previous call.)  
Type: String  
Required: No

 **Names.member.N**   
The names of the policies.  
Type: Array of strings  
Required: No

 ** PageSize **   
The maximum number of results to return with this call.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 400.  
Required: No

## Response Elements
<a name="API_DescribeSSLPolicies_ResponseElements"></a>

The following elements are returned by the service.

 ** NextMarker **   
If there are additional results, this is the marker for the next set of results. Otherwise, this is null.  
Type: String

 **SslPolicies.member.N**   
Information about the security policies.  
Type: Array of [SslPolicy](API_SslPolicy.md) objects

## Errors
<a name="API_DescribeSSLPolicies_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** SSLPolicyNotFound **   
The specified SSL policy does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeSSLPolicies_Examples"></a>

### Describe the specified policy used for SSL negotiation
<a name="API_DescribeSSLPolicies_Example_1"></a>

This example describes the specified policy used for SSL negotiation.

#### Sample Request
<a name="API_DescribeSSLPolicies_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeSSLPolicies
&Names.member.1=ELBSecurityPolicy-2016-08
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_DescribeSSLPolicies_Example_1_Response"></a>

```
<DescribeSSLPoliciesResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <DescribeSSLPoliciesResult> 
    <SslPolicies> 
      <member> 
        <Ciphers> 
          <member> 
            <Name>ECDHE-ECDSA-AES128-GCM-SHA256</Name> 
            <Priority>1</Priority> 
          </member> 
          <member> 
            <Name>ECDHE-RSA-AES128-GCM-SHA256</Name> 
            <Priority>2</Priority> 
          </member> 
          <member> 
            <Name>ECDHE-ECDSA-AES128-SHA256</Name> 
            <Priority>3</Priority> 
          </member> 
          ...
          <member> 
            <Name>AES256-SHA</Name> 
            <Priority>19</Priority> 
          </member> 
        </Ciphers> 
        <Name>ELBSecurityPolicy-2016-08</Name> 
        <SslProtocols> 
          <member>TLSv1</member> 
          <member>TLSv1.1</member> 
          <member>TLSv1.2</member> 
        </SslProtocols> 
      </member> 
    </SslPolicies> 
  </DescribeSSLPoliciesResult> 
  <ResponseMetadata> 
    <RequestId>a78c9aee-f2aa-11e5-8a24-ffe2bf8623ae</RequestId> 
  </ResponseMetadata>
</DescribeSSLPoliciesResponse>
```

### Describe all policies used for SSL negotiation
<a name="API_DescribeSSLPolicies_Example_2"></a>

This example describes all the policies that you can use for SSL negotiation.

#### Sample Request
<a name="API_DescribeSSLPolicies_Example_2_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeSSLPolicies
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_DescribeSSLPolicies_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeSSLPolicies) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeSSLPolicies) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeSSLPolicies) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeSSLPolicies) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeSSLPolicies) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeSSLPolicies) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeSSLPolicies) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeSSLPolicies) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeSSLPolicies) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeSSLPolicies) 

# DescribeTags
<a name="API_DescribeTags"></a>

Describes the tags for the specified Elastic Load Balancing resources. You can describe the tags for one or more Application Load Balancers, Network Load Balancers, Gateway Load Balancers, target groups, listeners, or rules.

## Request Parameters
<a name="API_DescribeTags_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **ResourceArns.member.N**   
The Amazon Resource Names (ARN) of the resources. You can specify up to 20 resources in a single call.  
Type: Array of strings  
Required: Yes

## Response Elements
<a name="API_DescribeTags_ResponseElements"></a>

The following element is returned by the service.

 **TagDescriptions.member.N**   
Information about the tags.  
Type: Array of [TagDescription](API_TagDescription.md) objects

## Errors
<a name="API_DescribeTags_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ListenerNotFound **   
The specified listener does not exist.  
HTTP Status Code: 400

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

 ** RuleNotFound **   
The specified rule does not exist.  
HTTP Status Code: 400

 ** TargetGroupNotFound **   
The specified target group does not exist.  
HTTP Status Code: 400

 ** TrustStoreNotFound **   
The specified trust store does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeTags_Examples"></a>

### Describe the tags assigned to a load balancer
<a name="API_DescribeTags_Example_1"></a>

This example describes the tags assigned to the specified load balancer.

#### Sample Request
<a name="API_DescribeTags_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeTags
&ResourceArns.member.1=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_DescribeTags_Example_1_Response"></a>

```
<DescribeTagsResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <DescribeTagsResult> 
    <TagDescriptions> 
      <member> 
        <ResourceArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188</ResourceArn> 
        <Tags> 
          <member> 
            <Value>lima</Value> 
            <Key>project</Key> 
          </member> 
          <member> 
            <Value>digital-media</Value> 
            <Key>department</Key> 
          </member> 
        </Tags> 
      </member> 
    </TagDescriptions> 
  </DescribeTagsResult> 
  <ResponseMetadata> 
    <RequestId>34f144db-f2d9-11e5-a53c-67205c0d10fd</RequestId> 
  </ResponseMetadata>
</DescribeTagsResponse>
```

## See Also
<a name="API_DescribeTags_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeTags) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeTags) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeTags) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeTags) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeTags) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeTags) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeTags) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeTags) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeTags) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeTags) 

# DescribeTargetGroupAttributes
<a name="API_DescribeTargetGroupAttributes"></a>

Describes the attributes for the specified target group.

For more information, see the following:
+  [Target group attributes](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html#target-group-attributes) in the *Application Load Balancers Guide* 
+  [Target group attributes](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-target-groups.html#target-group-attributes) in the *Network Load Balancers Guide* 
+  [Target group attributes](https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/target-groups.html#target-group-attributes) in the *Gateway Load Balancers Guide* 

## Request Parameters
<a name="API_DescribeTargetGroupAttributes_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** TargetGroupArn **   
The Amazon Resource Name (ARN) of the target group.  
Type: String  
Required: Yes

## Response Elements
<a name="API_DescribeTargetGroupAttributes_ResponseElements"></a>

The following element is returned by the service.

 **Attributes.member.N**   
Information about the target group attributes  
Type: Array of [TargetGroupAttribute](API_TargetGroupAttribute.md) objects

## Errors
<a name="API_DescribeTargetGroupAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** TargetGroupNotFound **   
The specified target group does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeTargetGroupAttributes_Examples"></a>

### Describe target group attributes
<a name="API_DescribeTargetGroupAttributes_Example_1"></a>

This example describes the attributes of the specified target group.

#### Sample Request
<a name="API_DescribeTargetGroupAttributes_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeTargetGroupAttributes
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_DescribeTargetGroupAttributes_Example_1_Response"></a>

```
<DescribeTargetGroupAttributesResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <DescribeTargetGroupAttributesResult> 
    <Attributes> 
      <member> 
        <Value>300</Value> 
        <Key>deregistration_delay.timeout_seconds</Key> 
      </member> 
    </Attributes> 
  </DescribeTargetGroupAttributesResult> 
  <ResponseMetadata> 
    <RequestId>54618294-f3a8-11e5-bb98-57195a6eb84a</RequestId> 
  </ResponseMetadata> 
</DescribeTargetGroupAttributesResponse>
```

## See Also
<a name="API_DescribeTargetGroupAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeTargetGroupAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeTargetGroupAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeTargetGroupAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeTargetGroupAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeTargetGroupAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeTargetGroupAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeTargetGroupAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeTargetGroupAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeTargetGroupAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeTargetGroupAttributes) 

# DescribeTargetGroups
<a name="API_DescribeTargetGroups"></a>

Describes the specified target groups or all of your target groups. By default, all target groups are described. Alternatively, you can specify one of the following to filter the results: the ARN of the load balancer, the names of one or more target groups, or the ARNs of one or more target groups.

To describe the targets for a target group, use [DescribeTargetHealth](API_DescribeTargetHealth.md). To describe the attributes of a target group, use [DescribeTargetGroupAttributes](API_DescribeTargetGroupAttributes.md).

## Request Parameters
<a name="API_DescribeTargetGroups_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** LoadBalancerArn **   
The Amazon Resource Name (ARN) of the load balancer.  
Type: String  
Required: No

 ** Marker **   
The marker for the next set of results. (You received this marker from a previous call.)  
Type: String  
Required: No

 **Names.member.N**   
The names of the target groups.  
Type: Array of strings  
Required: No

 ** PageSize **   
The maximum number of results to return with this call.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 400.  
Required: No

 **TargetGroupArns.member.N**   
The Amazon Resource Names (ARN) of the target groups.  
Type: Array of strings  
Required: No

## Response Elements
<a name="API_DescribeTargetGroups_ResponseElements"></a>

The following elements are returned by the service.

 ** NextMarker **   
If there are additional results, this is the marker for the next set of results. Otherwise, this is null.  
Type: String

 **TargetGroups.member.N**   
Information about the target groups.  
Type: Array of [TargetGroup](API_TargetGroup.md) objects

## Errors
<a name="API_DescribeTargetGroups_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

 ** TargetGroupNotFound **   
The specified target group does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeTargetGroups_Examples"></a>

### Describe a target group
<a name="API_DescribeTargetGroups_Example_1"></a>

This example describes the specified target group.

#### Sample Request
<a name="API_DescribeTargetGroups_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeTargetGroups
&TargetGroupArns.member.1=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_DescribeTargetGroups_Example_1_Response"></a>

```
<DescribeTargetGroupsResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <DescribeTargetGroupsResult> 
    <TargetGroups> 
      <member> 
        <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067</TargetGroupArn> 
        <HealthCheckTimeoutSeconds>5</HealthCheckTimeoutSeconds> 
        <HealthCheckPort>traffic-port</HealthCheckPort> 
        <Matcher> 
          <HttpCode>200</HttpCode> 
        </Matcher> 
        <TargetGroupName>my-targets</TargetGroupName> 
        <HealthCheckProtocol>HTTP</HealthCheckProtocol> 
        <HealthCheckPath>/</HealthCheckPath> 
        <Protocol>HTTP</Protocol> 
        <Port>80</Port> 
        <VpcId>vpc-3ac0fb5f</VpcId> 
        <HealthyThresholdCount>5</HealthyThresholdCount> 
        <HealthCheckIntervalSeconds>30</HealthCheckIntervalSeconds> 
        <LoadBalancerArns> 
          <member>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188</member> 
        </LoadBalancerArns> 
        <UnhealthyThresholdCount>2</UnhealthyThresholdCount> 
      </member> 
    </TargetGroups> 
  </DescribeTargetGroupsResult> 
  <ResponseMetadata> 
    <RequestId>70092c0e-f3a9-11e5-ae48-cff02092876b</RequestId> 
  </ResponseMetadata> 
</DescribeTargetGroupsResponse>
```

### Describe all target groups for a load balancer
<a name="API_DescribeTargetGroups_Example_2"></a>

This example describes all target groups for the specified load balancer.

#### Sample Request
<a name="API_DescribeTargetGroups_Example_2_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeTargetGroups
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Version=2015-12-01
&AUTHPARAMS
```

### Describe all target groups
<a name="API_DescribeTargetGroups_Example_3"></a>

This example describes all of your target groups.

#### Sample Request
<a name="API_DescribeTargetGroups_Example_3_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeTargetGroups
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_DescribeTargetGroups_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeTargetGroups) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeTargetGroups) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeTargetGroups) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeTargetGroups) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeTargetGroups) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeTargetGroups) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeTargetGroups) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeTargetGroups) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeTargetGroups) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeTargetGroups) 

# DescribeTargetHealth
<a name="API_DescribeTargetHealth"></a>

Describes the health of the specified targets or all of your targets.

## Request Parameters
<a name="API_DescribeTargetHealth_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **Include.member.N**   
Used to include anomaly detection information.  
Type: Array of strings  
Valid Values: `AnomalyDetection | All`   
Required: No

 ** TargetGroupArn **   
The Amazon Resource Name (ARN) of the target group.  
Type: String  
Required: Yes

 **Targets.member.N**   
The targets.  
Type: Array of [TargetDescription](API_TargetDescription.md) objects  
Required: No

## Response Elements
<a name="API_DescribeTargetHealth_ResponseElements"></a>

The following element is returned by the service.

 **TargetHealthDescriptions.member.N**   
Information about the health of the targets.  
Type: Array of [TargetHealthDescription](API_TargetHealthDescription.md) objects

## Errors
<a name="API_DescribeTargetHealth_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** HealthUnavailable **   
The health of the specified targets could not be retrieved due to an internal error.  
HTTP Status Code: 500

 ** InvalidTarget **   
The specified target does not exist, is not in the same VPC as the target group, or has an unsupported instance type.  
HTTP Status Code: 400

 ** TargetGroupNotFound **   
The specified target group does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeTargetHealth_Examples"></a>

### Describe the health of the targets for a target group
<a name="API_DescribeTargetHealth_Example_1"></a>

This example describes the health of the targets for the specified target group. These targets are healthy.

#### Sample Request
<a name="API_DescribeTargetHealth_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeTargetHealth
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_DescribeTargetHealth_Example_1_Response"></a>

```
<DescribeTargetHealthResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <DescribeTargetHealthResult> 
    <TargetHealthDescriptions> 
      <member>
        <HealthCheckPort>80</HealthCheckPort>
        <TargetHealth> 
          <State>healthy</State> 
        </TargetHealth> 
        <Target> 
          <Port>80</Port> 
          <Id>i-0f76fade</Id> 
        </Target> 
      </member>
      <member>
        <HealthCheckPort>80</HealthCheckPort>
        <TargetHealth> 
          <State>healthy</State> 
        </TargetHealth> 
        <Target> 
          <Port>80</Port> 
          <Id>i-0f76fade</Id> 
        </Target> 
      </member> 
    </TargetHealthDescriptions> 
  </DescribeTargetHealthResult> 
  <ResponseMetadata> 
    <RequestId>c534f810-f389-11e5-9192-3fff33344cfa</RequestId> 
  </ResponseMetadata>
</DescribeTargetHealthResponse>
```

### Describe the health of the specified target
<a name="API_DescribeTargetHealth_Example_2"></a>

This example describes the health of the specified target. This target is healthy.

#### Sample Request
<a name="API_DescribeTargetHealth_Example_2_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeTargetHealth
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Targets.member.1.Id=i-0f76fade
&Targets.member.1.Port=80
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_DescribeTargetHealth_Example_2_Response"></a>

```
<DescribeTargetHealthResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <DescribeTargetHealthResult> 
    <TargetHealthDescriptions> 
      <member>
        <HealthCheckPort>80</HealthCheckPort>
        <TargetHealth> 
          <State>healthy</State> 
        </TargetHealth> 
        <Target> 
          <Port>80</Port> 
          <Id>i-0f76fade</Id> 
        </Target> 
      </member>
    </TargetHealthDescriptions> 
  </DescribeTargetHealthResult> 
  <ResponseMetadata> 
    <RequestId>c534f810-f389-11e5-9192-3fff33344cfa</RequestId> 
  </ResponseMetadata>
</DescribeTargetHealthResponse>
```

## See Also
<a name="API_DescribeTargetHealth_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeTargetHealth) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeTargetHealth) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeTargetHealth) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeTargetHealth) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeTargetHealth) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeTargetHealth) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeTargetHealth) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeTargetHealth) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeTargetHealth) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeTargetHealth) 

# DescribeTrustStoreAssociations
<a name="API_DescribeTrustStoreAssociations"></a>

Describes all resources associated with the specified trust store.

## Request Parameters
<a name="API_DescribeTrustStoreAssociations_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** Marker **   
The marker for the next set of results. (You received this marker from a previous call.)  
Type: String  
Required: No

 ** PageSize **   
The maximum number of results to return with this call.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 400.  
Required: No

 ** TrustStoreArn **   
The Amazon Resource Name (ARN) of the trust store.  
Type: String  
Required: Yes

## Response Elements
<a name="API_DescribeTrustStoreAssociations_ResponseElements"></a>

The following elements are returned by the service.

 ** NextMarker **   
If there are additional results, this is the marker for the next set of results. Otherwise, this is null.  
Type: String

 **TrustStoreAssociations.member.N**   
Information about the resources the trust store is associated to.  
Type: Array of [TrustStoreAssociation](API_TrustStoreAssociation.md) objects

## Errors
<a name="API_DescribeTrustStoreAssociations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** TrustStoreNotFound **   
The specified trust store does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeTrustStoreAssociations_Examples"></a>

### Describe all resources associated with a trust store.
<a name="API_DescribeTrustStoreAssociations_Example_1"></a>

This example describes all resources associated to the specified trust store.

#### Sample Request
<a name="API_DescribeTrustStoreAssociations_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeTrustStoreAssociations
&TrustStoreArn=arn:aws:elasticloadbalancing:us-east-1:111122223333:truststore/my-trust-store/3ym756xh7yj
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_DescribeTrustStoreAssociations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreAssociations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreAssociations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreAssociations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreAssociations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreAssociations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreAssociations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreAssociations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreAssociations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreAssociations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreAssociations) 

# DescribeTrustStoreRevocations
<a name="API_DescribeTrustStoreRevocations"></a>

Describes the revocation files in use by the specified trust store or revocation files.

## Request Parameters
<a name="API_DescribeTrustStoreRevocations_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** Marker **   
The marker for the next set of results. (You received this marker from a previous call.)  
Type: String  
Required: No

 ** PageSize **   
The maximum number of results to return with this call.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 400.  
Required: No

 **RevocationIds.member.N**   
The revocation IDs of the revocation files you want to describe.  
Type: Array of longs  
Required: No

 ** TrustStoreArn **   
The Amazon Resource Name (ARN) of the trust store.  
Type: String  
Required: Yes

## Response Elements
<a name="API_DescribeTrustStoreRevocations_ResponseElements"></a>

The following elements are returned by the service.

 ** NextMarker **   
If there are additional results, this is the marker for the next set of results. Otherwise, this is null.  
Type: String

 **TrustStoreRevocations.member.N**   
Information about the revocation file in the trust store.  
Type: Array of [DescribeTrustStoreRevocation](API_DescribeTrustStoreRevocation.md) objects

## Errors
<a name="API_DescribeTrustStoreRevocations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** RevocationIdNotFound **   
The specified revocation ID does not exist.  
HTTP Status Code: 400

 ** TrustStoreNotFound **   
The specified trust store does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeTrustStoreRevocations_Examples"></a>

### Describe revocation file contents from a trust store.
<a name="API_DescribeTrustStoreRevocations_Example_1"></a>

This example describes the specified certificate revocation IDs list contents from the specified trust store.

#### Sample Request
<a name="API_DescribeTrustStoreRevocations_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeTrustStoreRevocations
&TrustStoreArn=arn:aws:elasticloadbalancing:us-east-1:111122223333:truststore/my-trust-store/3ym756xh7yj
&RevocationIds.member.1.RevocationId=1
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_DescribeTrustStoreRevocations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreRevocations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreRevocations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreRevocations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreRevocations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreRevocations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreRevocations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreRevocations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreRevocations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreRevocations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeTrustStoreRevocations) 

# DescribeTrustStores
<a name="API_DescribeTrustStores"></a>

Describes all trust stores for the specified account.

## Request Parameters
<a name="API_DescribeTrustStores_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** Marker **   
The marker for the next set of results. (You received this marker from a previous call.)  
Type: String  
Required: No

 **Names.member.N**   
The names of the trust stores.  
Type: Array of strings  
Length Constraints: Minimum length of 1. Maximum length of 32.  
Pattern: `^([a-zA-Z0-9]+-)*[a-zA-Z0-9]+$`   
Required: No

 ** PageSize **   
The maximum number of results to return with this call.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 400.  
Required: No

 **TrustStoreArns.member.N**   
The Amazon Resource Name (ARN) of the trust store.  
Type: Array of strings  
Required: No

## Response Elements
<a name="API_DescribeTrustStores_ResponseElements"></a>

The following elements are returned by the service.

 ** NextMarker **   
If there are additional results, this is the marker for the next set of results. Otherwise, this is null.  
Type: String

 **TrustStores.member.N**   
Information about the trust stores.  
Type: Array of [TrustStore](API_TrustStore.md) objects

## Errors
<a name="API_DescribeTrustStores_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** TrustStoreNotFound **   
The specified trust store does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeTrustStores_Examples"></a>

### Describe a trust store.
<a name="API_DescribeTrustStores_Example_1"></a>

This example describes the specified trust store.

#### Sample Request
<a name="API_DescribeTrustStores_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=DescribeTrustStores
&TrustStoreArns.member.1.TrustStoreArn=arn:aws:elasticloadbalancing:us-east-1:111122223333:truststore/my-trust-store/3ym756xh7yj
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_DescribeTrustStores_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/DescribeTrustStores) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/DescribeTrustStores) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/DescribeTrustStores) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/DescribeTrustStores) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/DescribeTrustStores) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/DescribeTrustStores) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/DescribeTrustStores) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/DescribeTrustStores) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/DescribeTrustStores) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/DescribeTrustStores) 

# GetResourcePolicy
<a name="API_GetResourcePolicy"></a>

Retrieves the resource policy for a specified resource.

## Request Parameters
<a name="API_GetResourcePolicy_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** ResourceArn **   
The Amazon Resource Name (ARN) of the resource.  
Type: String  
Required: Yes

## Response Elements
<a name="API_GetResourcePolicy_ResponseElements"></a>

The following element is returned by the service.

 ** Policy **   
The content of the resource policy.  
Type: String  
Length Constraints: Minimum length of 1.

## Errors
<a name="API_GetResourcePolicy_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ResourceNotFound **   
The specified resource does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_GetResourcePolicy_Examples"></a>

### Retrieve a resource policy
<a name="API_GetResourcePolicy_Example_1"></a>

This example retrieves the resource policy for the specified trust store.

#### Sample Request
<a name="API_GetResourcePolicy_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=GetResourcePolicy
&ResourceArn=arn:aws:elasticloadbalancing:us-east-1:123456789012:truststore/my-trust-store/73e2d6bc24d8a067
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_GetResourcePolicy_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/GetResourcePolicy) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/GetResourcePolicy) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/GetResourcePolicy) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/GetResourcePolicy) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/GetResourcePolicy) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/GetResourcePolicy) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/GetResourcePolicy) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/GetResourcePolicy) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/GetResourcePolicy) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/GetResourcePolicy) 

# GetTrustStoreCaCertificatesBundle
<a name="API_GetTrustStoreCaCertificatesBundle"></a>

Retrieves the ca certificate bundle.

This action returns a pre-signed S3 URI which is active for ten minutes.

## Request Parameters
<a name="API_GetTrustStoreCaCertificatesBundle_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** TrustStoreArn **   
The Amazon Resource Name (ARN) of the trust store.  
Type: String  
Required: Yes

## Response Elements
<a name="API_GetTrustStoreCaCertificatesBundle_ResponseElements"></a>

The following element is returned by the service.

 ** Location **   
The ca certificate bundles Amazon S3 URI.  
Type: String

## Errors
<a name="API_GetTrustStoreCaCertificatesBundle_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** TrustStoreNotFound **   
The specified trust store does not exist.  
HTTP Status Code: 400

## See Also
<a name="API_GetTrustStoreCaCertificatesBundle_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/GetTrustStoreCaCertificatesBundle) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/GetTrustStoreCaCertificatesBundle) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/GetTrustStoreCaCertificatesBundle) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/GetTrustStoreCaCertificatesBundle) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/GetTrustStoreCaCertificatesBundle) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/GetTrustStoreCaCertificatesBundle) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/GetTrustStoreCaCertificatesBundle) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/GetTrustStoreCaCertificatesBundle) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/GetTrustStoreCaCertificatesBundle) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/GetTrustStoreCaCertificatesBundle) 

# GetTrustStoreRevocationContent
<a name="API_GetTrustStoreRevocationContent"></a>

Retrieves the specified revocation file.

This action returns a pre-signed S3 URI which is active for ten minutes.

## Request Parameters
<a name="API_GetTrustStoreRevocationContent_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** RevocationId **   
The revocation ID of the revocation file.  
Type: Long  
Required: Yes

 ** TrustStoreArn **   
The Amazon Resource Name (ARN) of the trust store.  
Type: String  
Required: Yes

## Response Elements
<a name="API_GetTrustStoreRevocationContent_ResponseElements"></a>

The following element is returned by the service.

 ** Location **   
The revocation files Amazon S3 URI.  
Type: String

## Errors
<a name="API_GetTrustStoreRevocationContent_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** RevocationIdNotFound **   
The specified revocation ID does not exist.  
HTTP Status Code: 400

 ** TrustStoreNotFound **   
The specified trust store does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_GetTrustStoreRevocationContent_Examples"></a>

### Retrieve a certificate revocation list.
<a name="API_GetTrustStoreRevocationContent_Example_1"></a>

This example retrieves the specified certificate revocation IDs list contents from the specified trust store and provides a pre-signed S3 URI.

#### Sample Request
<a name="API_GetTrustStoreRevocationContent_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=GetTrustStoreRevocationContent
&TrustStoreArn=arn:aws:elasticloadbalancing:us-east-1:111122223333:truststore/my-trust-store/3ym756xh7yj
&RevocationId=1
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_GetTrustStoreRevocationContent_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/GetTrustStoreRevocationContent) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/GetTrustStoreRevocationContent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/GetTrustStoreRevocationContent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/GetTrustStoreRevocationContent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/GetTrustStoreRevocationContent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/GetTrustStoreRevocationContent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/GetTrustStoreRevocationContent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/GetTrustStoreRevocationContent) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/GetTrustStoreRevocationContent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/GetTrustStoreRevocationContent) 

# ModifyCapacityReservation
<a name="API_ModifyCapacityReservation"></a>

Modifies the capacity reservation of the specified load balancer.

When modifying capacity reservation, you must include at least one `MinimumLoadBalancerCapacity` or `ResetCapacityReservation`.

## Request Parameters
<a name="API_ModifyCapacityReservation_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** LoadBalancerArn **   
The Amazon Resource Name (ARN) of the load balancer.  
Type: String  
Required: Yes

 ** MinimumLoadBalancerCapacity **   
The minimum load balancer capacity reserved.  
Type: [MinimumLoadBalancerCapacity](API_MinimumLoadBalancerCapacity.md) object  
Required: No

 ** ResetCapacityReservation **   
Resets the capacity reservation.  
Type: Boolean  
Required: No

## Response Elements
<a name="API_ModifyCapacityReservation_ResponseElements"></a>

The following elements are returned by the service.

 **CapacityReservationState.member.N**   
The state of the capacity reservation.  
Type: Array of [ZonalCapacityReservationState](API_ZonalCapacityReservationState.md) objects

 ** DecreaseRequestsRemaining **   
The amount of daily capacity decreases remaining.  
Type: Integer

 ** LastModifiedTime **   
The last time the capacity reservation was modified.  
Type: Timestamp

 ** MinimumLoadBalancerCapacity **   
The requested minimum capacity reservation for the load balancer  
Type: [MinimumLoadBalancerCapacity](API_MinimumLoadBalancerCapacity.md) object

## Errors
<a name="API_ModifyCapacityReservation_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** CapacityDecreaseRequestLimitExceeded **   
You've exceeded the daily capacity decrease limit for this reservation.  
HTTP Status Code: 400

 ** CapacityReservationPending **   
There is a pending capacity reservation.  
HTTP Status Code: 400

 ** CapacityUnitsLimitExceeded **   
You've exceeded the capacity units limit.  
HTTP Status Code: 400

 ** InsufficientCapacity **   
There is insufficient capacity to reserve.  
HTTP Status Code: 500

 ** InvalidConfigurationRequest **   
The requested configuration is not valid.  
HTTP Status Code: 400

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

 ** OperationNotPermitted **   
This operation is not allowed.  
HTTP Status Code: 400

 ** PriorRequestNotComplete **   
This operation is not allowed while a prior request has not been completed.  
HTTP Status Code: 429

## See Also
<a name="API_ModifyCapacityReservation_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/ModifyCapacityReservation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/ModifyCapacityReservation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/ModifyCapacityReservation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/ModifyCapacityReservation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/ModifyCapacityReservation) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/ModifyCapacityReservation) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/ModifyCapacityReservation) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/ModifyCapacityReservation) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/ModifyCapacityReservation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/ModifyCapacityReservation) 

# ModifyIpPools
<a name="API_ModifyIpPools"></a>

[Application Load Balancers] Modify the IP pool associated to a load balancer.

## Request Parameters
<a name="API_ModifyIpPools_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** IpamPools **   
The IPAM pools to be modified.  
Type: [IpamPools](API_IpamPools.md) object  
Required: No

 ** LoadBalancerArn **   
The Amazon Resource Name (ARN) of the load balancer.  
Type: String  
Required: Yes

 **RemoveIpamPools.member.N**   
Remove the IP pools in use by the load balancer.  
Type: Array of strings  
Valid Values: `ipv4`   
Required: No

## Response Elements
<a name="API_ModifyIpPools_ResponseElements"></a>

The following element is returned by the service.

 ** IpamPools **   
The IPAM pool ID.  
Type: [IpamPools](API_IpamPools.md) object

## Errors
<a name="API_ModifyIpPools_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

## See Also
<a name="API_ModifyIpPools_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/ModifyIpPools) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/ModifyIpPools) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/ModifyIpPools) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/ModifyIpPools) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/ModifyIpPools) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/ModifyIpPools) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/ModifyIpPools) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/ModifyIpPools) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/ModifyIpPools) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/ModifyIpPools) 

# ModifyListener
<a name="API_ModifyListener"></a>

Replaces the specified properties of the specified listener. Any properties that you do not specify remain unchanged.

Changing the protocol from HTTPS to HTTP, or from TLS to TCP, removes the security policy and default certificate properties. If you change the protocol from HTTP to HTTPS, or from TCP to TLS, you must add the security policy and default certificate properties.

To add an item to a list, remove an item from a list, or update an item in a list, you must provide the entire list. For example, to add an action, specify a list with the current actions plus the new action.

## Request Parameters
<a name="API_ModifyListener_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **AlpnPolicy.member.N**   
[TLS listeners] The name of the Application-Layer Protocol Negotiation (ALPN) policy. You can specify one policy name. The following are the possible values:  
+  `HTTP1Only` 
+  `HTTP2Only` 
+  `HTTP2Optional` 
+  `HTTP2Preferred` 
+  `None` 
For more information, see [ALPN policies](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-listeners.html#alpn-policies) in the *Network Load Balancers Guide*.  
Type: Array of strings  
Required: No

 **Certificates.member.N**   
[HTTPS and TLS listeners] The default certificate for the listener. You must provide exactly one certificate. Set `CertificateArn` to the certificate ARN but do not set `IsDefault`.  
To create a certificate list, use [AddListenerCertificates](API_AddListenerCertificates.md).  
Type: Array of [Certificate](API_Certificate.md) objects  
Required: No

 **DefaultActions.member.N**   
The actions for the default rule.  
Type: Array of [Action](API_Action.md) objects  
Required: No

 ** ListenerArn **   
The Amazon Resource Name (ARN) of the listener.  
Type: String  
Required: Yes

 ** MutualAuthentication **   
[HTTPS listeners] The mutual authentication configuration information.  
Type: [MutualAuthenticationAttributes](API_MutualAuthenticationAttributes.md) object  
Required: No

 ** Port **   
The port for connections from clients to the load balancer. You can't specify a port for a Gateway Load Balancer.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 65535.  
Required: No

 ** Protocol **   
The protocol for connections from clients to the load balancer. Application Load Balancers support the HTTP and HTTPS protocols. Network Load Balancers support the TCP, TLS, UDP, TCP\$1UDP, QUIC, and TCP\$1QUIC protocols. You can’t change the protocol to UDP, TCP\$1UDP, QUIC, or TCP\$1QUIC if dual-stack mode is enabled. You can't specify a protocol for a Gateway Load Balancer.  
Type: String  
Valid Values: `HTTP | HTTPS | TCP | TLS | UDP | TCP_UDP | GENEVE | QUIC | TCP_QUIC`   
Required: No

 ** SslPolicy **   
[HTTPS and TLS listeners] The security policy that defines which protocols and ciphers are supported.  
For more information, see [Security policies](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/describe-ssl-policies.html) in the *Application Load Balancers Guide* or [Security policies](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/describe-ssl-policies.html) in the *Network Load Balancers Guide*.  
Type: String  
Required: No

## Response Elements
<a name="API_ModifyListener_ResponseElements"></a>

The following element is returned by the service.

 **Listeners.member.N**   
Information about the modified listener.  
Type: Array of [Listener](API_Listener.md) objects

## Errors
<a name="API_ModifyListener_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ALPNPolicyNotFound **   
The specified ALPN policy is not supported.  
HTTP Status Code: 400

 ** CertificateNotFound **   
The specified certificate does not exist.  
HTTP Status Code: 400

 ** DuplicateListener **   
A listener with the specified port already exists.  
HTTP Status Code: 400

 ** IncompatibleProtocols **   
The specified configuration is not valid with this protocol.  
HTTP Status Code: 400

 ** InvalidConfigurationRequest **   
The requested configuration is not valid.  
HTTP Status Code: 400

 ** InvalidLoadBalancerAction **   
The requested action is not valid.  
HTTP Status Code: 400

 ** ListenerNotFound **   
The specified listener does not exist.  
HTTP Status Code: 400

 ** SSLPolicyNotFound **   
The specified SSL policy does not exist.  
HTTP Status Code: 400

 ** TargetGroupAssociationLimit **   
You've reached the limit on the number of load balancers per target group.  
HTTP Status Code: 400

 ** TargetGroupNotFound **   
The specified target group does not exist.  
HTTP Status Code: 400

 ** TooManyActions **   
You've reached the limit on the number of actions per rule.  
HTTP Status Code: 400

 ** TooManyCertificates **   
You've reached the limit on the number of certificates per load balancer.  
HTTP Status Code: 400

 ** TooManyListeners **   
You've reached the limit on the number of listeners per load balancer.  
HTTP Status Code: 400

 ** TooManyRegistrationsForTargetId **   
You've reached the limit on the number of times a target can be registered with a load balancer.  
HTTP Status Code: 400

 ** TooManyTargets **   
You've reached the limit on the number of targets.  
HTTP Status Code: 400

 ** TooManyUniqueTargetGroupsPerLoadBalancer **   
You've reached the limit on the number of unique target groups per load balancer across all listeners. If a target group is used by multiple actions for a load balancer, it is counted as only one use.  
HTTP Status Code: 400

 ** TrustStoreNotFound **   
The specified trust store does not exist.  
HTTP Status Code: 400

 ** TrustStoreNotReady **   
The specified trust store is not active.  
HTTP Status Code: 400

 ** UnsupportedProtocol **   
The specified protocol is not supported.  
HTTP Status Code: 400

## Examples
<a name="API_ModifyListener_Examples"></a>

### Change the default action
<a name="API_ModifyListener_Example_1"></a>

This example changes the default action for the specified listener.

#### Sample Request
<a name="API_ModifyListener_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=ModifyListener
&ListenerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2
&DefaultActions.member.1.Type=forward
&DefaultActions.member.1.TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_ModifyListener_Example_1_Response"></a>

```
<ModifyListenerResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <ModifyListenerResult> 
    <Listeners> 
      <member> 
        <LoadBalancerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188</LoadBalancerArn> 
        <Protocol>HTTP</Protocol> 
        <Port>80</Port> 
        <ListenerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2</ListenerArn> 
        <DefaultActions> 
          <member> 
            <Type>forward</Type> 
            <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f</TargetGroupArn> 
          </member> 
        </DefaultActions> 
      </member> 
    </Listeners> 
  </ModifyListenerResult> 
  <ResponseMetadata> 
    <RequestId>9759b8df-f462-11e5-8a24-ffe2bf8623ae</RequestId> 
  </ResponseMetadata> 
</ModifyListenerResponse>
```

### Change the default certificate
<a name="API_ModifyListener_Example_2"></a>

This example changes the default certificate for the specified HTTPS listener.

#### Sample Request
<a name="API_ModifyListener_Example_2_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=ModifyListener
&ListenerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65
&Certificates.member.1.CertificateArn=arn:aws:iam::123456789012:server-certificate/my-new-server-cert
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_ModifyListener_Example_2_Response"></a>

```
<ModifyListenerResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <ModifyListenerResult> 
    <Listeners> 
      <member> 
        <LoadBalancerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188</LoadBalancerArn> 
        <Protocol>HTTPS</Protocol> 
        <Certificates> 
          <member> 
            <CertificateArn>arn:aws:iam::123456789012:server-certificate/my-new-server-cert</CertificateArn> 
          </member> 
        </Certificates> 
        <Port>443</Port> 
        <SslPolicy>ELBSecurityPolicy-2016-08</SslPolicy> 
        <ListenerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65</ListenerArn> 
        <DefaultActions> 
          <member> 
            <Type>forward</Type> 
            <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067</TargetGroupArn> 
          </member> 
        </DefaultActions> 
      </member> 
    </Listeners> 
  </ModifyListenerResult> 
  <ResponseMetadata> 
    <RequestId>3f72dcb2-f463-11e5-b95d-3b2c1831fc26</RequestId> 
  </ResponseMetadata> </ModifyListenerResponse>
```

### Change the security policy
<a name="API_ModifyListener_Example_3"></a>

This example changes the security policy for the specified HTTPS listener.

#### Sample Request
<a name="API_ModifyListener_Example_3_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=ModifyListener
&ListenerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65
&SslPolicy=ELBSecurityPolicy-2016-08
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_ModifyListener_Example_3_Response"></a>

```
<ModifyListenerResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <ModifyListenerResult> 
    <Listeners> 
      <member> 
        <LoadBalancerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188</LoadBalancerArn> 
        <Protocol>HTTPS</Protocol> 
        <Certificates> 
          <member> 
            <CertificateArn>arn:aws:iam::123456789012:server-certificate/my-server-cert</CertificateArn> 
          </member> 
        </Certificates> 
        <Port>443</Port> 
        <SslPolicy>ELBSecurityPolicy-2016-08</SslPolicy> 
        <ListenerArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65</ListenerArn> 
        <DefaultActions> 
          <member> 
            <Type>forward</Type> 
            <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067</TargetGroupArn> 
          </member> 
        </DefaultActions> 
      </member> 
    </Listeners> 
  </ModifyListenerResult> 
  <ResponseMetadata> 
    <RequestId>3f72dcb2-f463-11e5-b95d-3b2c1831fc26</RequestId> 
  </ResponseMetadata> 
</ModifyListenerResponse>
```

## See Also
<a name="API_ModifyListener_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/ModifyListener) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/ModifyListener) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/ModifyListener) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/ModifyListener) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/ModifyListener) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/ModifyListener) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/ModifyListener) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/ModifyListener) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/ModifyListener) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/ModifyListener) 

# ModifyListenerAttributes
<a name="API_ModifyListenerAttributes"></a>

Modifies the specified attributes of the specified listener.

## Request Parameters
<a name="API_ModifyListenerAttributes_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **Attributes.member.N**   
The listener attributes.  
Type: Array of [ListenerAttribute](API_ListenerAttribute.md) objects  
Required: Yes

 ** ListenerArn **   
The Amazon Resource Name (ARN) of the listener.  
Type: String  
Required: Yes

## Response Elements
<a name="API_ModifyListenerAttributes_ResponseElements"></a>

The following element is returned by the service.

 **Attributes.member.N**   
Information about the listener attributes.  
Type: Array of [ListenerAttribute](API_ListenerAttribute.md) objects

## Errors
<a name="API_ModifyListenerAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidConfigurationRequest **   
The requested configuration is not valid.  
HTTP Status Code: 400

 ** ListenerNotFound **   
The specified listener does not exist.  
HTTP Status Code: 400

## See Also
<a name="API_ModifyListenerAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/ModifyListenerAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/ModifyListenerAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/ModifyListenerAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/ModifyListenerAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/ModifyListenerAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/ModifyListenerAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/ModifyListenerAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/ModifyListenerAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/ModifyListenerAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/ModifyListenerAttributes) 

# ModifyLoadBalancerAttributes
<a name="API_ModifyLoadBalancerAttributes"></a>

Modifies the specified attributes of the specified Application Load Balancer, Network Load Balancer, or Gateway Load Balancer.

If any of the specified attributes can't be modified as requested, the call fails. Any existing attributes that you do not modify retain their current values.

## Request Parameters
<a name="API_ModifyLoadBalancerAttributes_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **Attributes.member.N**   
The load balancer attributes.  
Type: Array of [LoadBalancerAttribute](API_LoadBalancerAttribute.md) objects  
Array Members: Maximum number of 20 items.  
Required: Yes

 ** LoadBalancerArn **   
The Amazon Resource Name (ARN) of the load balancer.  
Type: String  
Required: Yes

## Response Elements
<a name="API_ModifyLoadBalancerAttributes_ResponseElements"></a>

The following element is returned by the service.

 **Attributes.member.N**   
Information about the load balancer attributes.  
Type: Array of [LoadBalancerAttribute](API_LoadBalancerAttribute.md) objects  
Array Members: Maximum number of 20 items.

## Errors
<a name="API_ModifyLoadBalancerAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidConfigurationRequest **   
The requested configuration is not valid.  
HTTP Status Code: 400

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_ModifyLoadBalancerAttributes_Examples"></a>

### Enable deletion protection
<a name="API_ModifyLoadBalancerAttributes_Example_1"></a>

This example enables deletion protection for the specified load balancer.

#### Sample Request
<a name="API_ModifyLoadBalancerAttributes_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=ModifyLoadBalancerAttributes
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Attributes.member.1.Key=deletion_protection.enabled
&Attributes.member.1.Value=true
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_ModifyLoadBalancerAttributes_Example_1_Response"></a>

```
<ModifyLoadBalancerAttributesResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <ModifyLoadBalancerAttributesResult> 
    <Attributes> 
      <member> 
        <Value>true</Value> 
        <Key>deletion_protection.enabled</Key> 
      </member> 
      <member> 
        <Value>false</Value> 
        <Key>access_logs.s3.enabled</Key> 
      </member> 
      <member> 
        <Value>60</Value> 
        <Key>idle_timeout.timeout_seconds</Key> 
      </member> 
      <member> 
        <Value /> 
        <Key>access_logs.s3.prefix</Key> 
      </member> 
      <member> 
        <Value /> 
        <Key>access_logs.s3.bucket</Key> 
      </member> 
    </Attributes> 
  </ModifyLoadBalancerAttributesResult> 
  <ResponseMetadata> 
    <RequestId>b2066529-f42c-11e5-b543-9f2c3fbb9bee</RequestId> 
  </ResponseMetadata> 
</ModifyLoadBalancerAttributesResponse>
```

### Change the idle timeout
<a name="API_ModifyLoadBalancerAttributes_Example_2"></a>

This example changes the idle timeout value for the specified Application Load Balancer.

#### Sample Request
<a name="API_ModifyLoadBalancerAttributes_Example_2_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=ModifyLoadBalancerAttributes
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Attributes.member.1.Key=idle_timeout.timeout_seconds
&Attributes.member.1.Value=30
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_ModifyLoadBalancerAttributes_Example_2_Response"></a>

```
<ModifyLoadBalancerAttributesResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <ModifyLoadBalancerAttributesResult> 
    <Attributes> 
      <member> 
        <Value>30</Value> 
        <Key>idle_timeout.timeout_seconds</Key> 
      </member> 
      <member> 
        <Value>false</Value> 
        <Key>access_logs.s3.enabled</Key> 
      </member> 
      <member> 
        <Value /> 
        <Key>access_logs.s3.prefix</Key> 
      </member> 
      <member> 
        <Value>false</Value> 
        <Key>deletion_protection.enabled</Key> 
      </member> 
      <member> 
        <Value /> 
        <Key>access_logs.s3.bucket</Key> 
      </member> 
    </Attributes> 
  </ModifyLoadBalancerAttributesResult> 
  <ResponseMetadata> 
    <RequestId>d3f6e6dc-f42c-11e5-b5ae-8bfaf16614ac</RequestId> 
  </ResponseMetadata> 
</ModifyLoadBalancerAttributesResponse>
```

### Enable access logs
<a name="API_ModifyLoadBalancerAttributes_Example_3"></a>

This example enables access logs for the specified Application Load Balancer. The S3 bucket must exist in the same Region as the load balancer and must have a bucket policy that grants Elastic Load Balancing permissions to write to the bucket.

#### Sample Request
<a name="API_ModifyLoadBalancerAttributes_Example_3_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=ModifyLoadBalancerAttributes
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Attributes.member.1.Key=access_logs.s3.enabled
&Attributes.member.1.Value=true
&Attributes.member.2.Key=access_logs.s3.bucket
&Attributes.member.2.Value=my-loadbalancer-logs
&Attributes.member.3.Key=access_logs.s3.prefix
&Attributes.member.3.Value=myapp
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_ModifyLoadBalancerAttributes_Example_3_Response"></a>

```
<ModifyLoadBalancerAttributesResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <ModifyLoadBalancerAttributesResult>
    <Attributes>
      <member>
        <Value>true</Value>
        <Key>access_logs.s3.enabled</Key>
      </member>
      <member>
        <Value>my-loadbalancer-logs</Value>
        <Key>access_logs.s3.bucket</Key>
      </member>
      <member>
        <Value>myapp</Value>
        <Key>access_logs.s3.prefix</Key>
      </member>
      <member>
        <Value>60</Value>
        <Key>idle_timeout.timeout_seconds</Key>
      </member>
      <member>
        <Value>false</Value>
        <Key>deletion_protection.enabled</Key>
      </member>
    </Attributes>
  </ModifyLoadBalancerAttributesResult>
  <ResponseMetadata>
    <RequestId>095cb76d-f52e-11e5-bb98-57195a6eb84a</RequestId>
  </ResponseMetadata>
</ModifyLoadBalancerAttributesResponse>
```

### Enable connection logs.
<a name="API_ModifyLoadBalancerAttributes_Example_4"></a>

This example enables connection logs, setting the specified S3 bucket and prefix location.

#### Sample Request
<a name="API_ModifyLoadBalancerAttributes_Example_4_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=ModifyLoadBalancerAttributes
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Attributes.member.1.Key=connection_logs.s3.enabled
&Attributes.member.1.Value=true
&Attributes.member.2.Key=connection_logs.s3.bucket
&Attributes.member.2.Value=my-loadbalancer-connection-logs
&Attributes.member.3.Key=connection_logs.s3.prefix
&Attributes.member.3.Value=myapp-connections
&Version=2015-12-01
&AUTHPARAMS
```

### Enable health check logs.
<a name="API_ModifyLoadBalancerAttributes_Example_5"></a>

This example enables health check logs, setting the specified S3 bucket and prefix location.

#### Sample Request
<a name="API_ModifyLoadBalancerAttributes_Example_5_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=ModifyLoadBalancerAttributes
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Attributes.member.1.Key=health_check_logs.s3.enabled
&Attributes.member.1.Value=true
&Attributes.member.2.Key=health_check_logs.s3.bucket
&Attributes.member.2.Value=my-loadbalancer-connection-logs
&Attributes.member.3.Key=health_check_logs.s3.prefix
&Attributes.member.3.Value=mylb-health
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_ModifyLoadBalancerAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/ModifyLoadBalancerAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/ModifyLoadBalancerAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/ModifyLoadBalancerAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/ModifyLoadBalancerAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/ModifyLoadBalancerAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/ModifyLoadBalancerAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/ModifyLoadBalancerAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/ModifyLoadBalancerAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/ModifyLoadBalancerAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/ModifyLoadBalancerAttributes) 

# ModifyRule
<a name="API_ModifyRule"></a>

Replaces the specified properties of the specified rule. Any properties that you do not specify are unchanged.

To add an item to a list, remove an item from a list, or update an item in a list, you must provide the entire list. For example, to add an action, specify a list with the current actions plus the new action.

To modify the actions for the default rule, use [ModifyListener](API_ModifyListener.md).

## Request Parameters
<a name="API_ModifyRule_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **Actions.member.N**   
The actions.  
Type: Array of [Action](API_Action.md) objects  
Required: No

 **Conditions.member.N**   
The conditions.  
Type: Array of [RuleCondition](API_RuleCondition.md) objects  
Required: No

 ** ResetTransforms **   
Indicates whether to remove all transforms from the rule. If you specify `ResetTransforms`, you can't specify `Transforms`.  
Type: Boolean  
Required: No

 ** RuleArn **   
The Amazon Resource Name (ARN) of the rule.  
Type: String  
Required: Yes

 **Transforms.member.N**   
The transforms to apply to requests that match this rule. You can add one host header rewrite transform and one URL rewrite transform. If you specify `Transforms`, you can't specify `ResetTransforms`.  
Type: Array of [RuleTransform](API_RuleTransform.md) objects  
Required: No

## Response Elements
<a name="API_ModifyRule_ResponseElements"></a>

The following element is returned by the service.

 **Rules.member.N**   
Information about the modified rule.  
Type: Array of [Rule](API_Rule.md) objects

## Errors
<a name="API_ModifyRule_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** IncompatibleProtocols **   
The specified configuration is not valid with this protocol.  
HTTP Status Code: 400

 ** InvalidLoadBalancerAction **   
The requested action is not valid.  
HTTP Status Code: 400

 ** OperationNotPermitted **   
This operation is not allowed.  
HTTP Status Code: 400

 ** RuleNotFound **   
The specified rule does not exist.  
HTTP Status Code: 400

 ** TargetGroupAssociationLimit **   
You've reached the limit on the number of load balancers per target group.  
HTTP Status Code: 400

 ** TargetGroupNotFound **   
The specified target group does not exist.  
HTTP Status Code: 400

 ** TooManyActions **   
You've reached the limit on the number of actions per rule.  
HTTP Status Code: 400

 ** TooManyRegistrationsForTargetId **   
You've reached the limit on the number of times a target can be registered with a load balancer.  
HTTP Status Code: 400

 ** TooManyTargets **   
You've reached the limit on the number of targets.  
HTTP Status Code: 400

 ** TooManyUniqueTargetGroupsPerLoadBalancer **   
You've reached the limit on the number of unique target groups per load balancer across all listeners. If a target group is used by multiple actions for a load balancer, it is counted as only one use.  
HTTP Status Code: 400

 ** UnsupportedProtocol **   
The specified protocol is not supported.  
HTTP Status Code: 400

## See Also
<a name="API_ModifyRule_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/ModifyRule) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/ModifyRule) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/ModifyRule) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/ModifyRule) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/ModifyRule) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/ModifyRule) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/ModifyRule) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/ModifyRule) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/ModifyRule) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/ModifyRule) 

# ModifyTargetGroup
<a name="API_ModifyTargetGroup"></a>

Modifies the health checks used when evaluating the health state of the targets in the specified target group.

To monitor the health of the targets, use [DescribeTargetHealth](API_DescribeTargetHealth.md).

## Request Parameters
<a name="API_ModifyTargetGroup_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** HealthCheckEnabled **   
Indicates whether health checks are enabled. If the target type is `lambda`, health checks are disabled by default but can be enabled. If the target type is `instance`, `ip`, or `alb`, health checks are always enabled and can't be disabled.  
Type: Boolean  
Required: No

 ** HealthCheckIntervalSeconds **   
The approximate amount of time, in seconds, between health checks of an individual target.  
Type: Integer  
Valid Range: Minimum value of 5. Maximum value of 300.  
Required: No

 ** HealthCheckPath **   
[HTTP/HTTPS health checks] The destination for health checks on the targets.  
[HTTP1 or HTTP2 protocol version] The ping path. The default is /.  
[GRPC protocol version] The path of a custom health check method with the format /package.service/method. The default is /AWS.ALB/healthcheck.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** HealthCheckPort **   
The port the load balancer uses when performing health checks on targets.  
Type: String  
Required: No

 ** HealthCheckProtocol **   
The protocol the load balancer uses when performing health checks on targets. For Application Load Balancers, the default is HTTP. For Network Load Balancers and Gateway Load Balancers, the default is TCP. The TCP protocol is not supported for health checks if the protocol of the target group is HTTP or HTTPS. It is supported for health checks only if the protocol of the target group is TCP, TLS, UDP, or TCP\$1UDP. The GENEVE, TLS, UDP, TCP\$1UDP, QUIC, and TCP\$1QUIC protocols are not supported for health checks.  
Type: String  
Valid Values: `HTTP | HTTPS | TCP | TLS | UDP | TCP_UDP | GENEVE | QUIC | TCP_QUIC`   
Required: No

 ** HealthCheckTimeoutSeconds **   
[HTTP/HTTPS health checks] The amount of time, in seconds, during which no response means a failed health check.  
Type: Integer  
Valid Range: Minimum value of 2. Maximum value of 120.  
Required: No

 ** HealthyThresholdCount **   
The number of consecutive health checks successes required before considering an unhealthy target healthy.  
Type: Integer  
Valid Range: Minimum value of 2. Maximum value of 10.  
Required: No

 ** Matcher **   
[HTTP/HTTPS health checks] The HTTP or gRPC codes to use when checking for a successful response from a target. For target groups with a protocol of TCP, TCP\$1UDP, UDP or TLS the range is 200-599. For target groups with a protocol of HTTP or HTTPS, the range is 200-499. For target groups with a protocol of GENEVE, the range is 200-399.  
Type: [Matcher](API_Matcher.md) object  
Required: No

 ** TargetGroupArn **   
The Amazon Resource Name (ARN) of the target group.  
Type: String  
Required: Yes

 ** UnhealthyThresholdCount **   
The number of consecutive health check failures required before considering the target unhealthy.  
Type: Integer  
Valid Range: Minimum value of 2. Maximum value of 10.  
Required: No

## Response Elements
<a name="API_ModifyTargetGroup_ResponseElements"></a>

The following element is returned by the service.

 **TargetGroups.member.N**   
Information about the modified target group.  
Type: Array of [TargetGroup](API_TargetGroup.md) objects

## Errors
<a name="API_ModifyTargetGroup_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidConfigurationRequest **   
The requested configuration is not valid.  
HTTP Status Code: 400

 ** TargetGroupNotFound **   
The specified target group does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_ModifyTargetGroup_Examples"></a>

### Modify the health check configuration for a target group
<a name="API_ModifyTargetGroup_Example_1"></a>

This example changes the configuration of the health checks used to evaluate the health of the targets for the specified target group.

#### Sample Request
<a name="API_ModifyTargetGroup_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=ModifyTargetGroup
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-https-targets/2453ed029918f21f
&HealthCheckProtocol=HTTPS
&HealthCheckPort=443
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_ModifyTargetGroup_Example_1_Response"></a>

```
<ModifyTargetGroupResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <ModifyTargetGroupResult> 
    <TargetGroups> 
      <member> 
        <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-https-targets/2453ed029918f21f</TargetGroupArn> 
        <HealthCheckTimeoutSeconds>5</HealthCheckTimeoutSeconds> 
        <HealthCheckPort>443</HealthCheckPort> 
        <Matcher> 
          <HttpCode>200</HttpCode> 
        </Matcher> 
        <TargetGroupName>my-https-targets</TargetGroupName> 
        <HealthCheckProtocol>HTTPS</HealthCheckProtocol> 
        <Protocol>HTTPS</Protocol> 
        <Port>443</Port> 
        <HealthyThresholdCount>5</HealthyThresholdCount> 
        <VpcId>vpc-3ac0fb5f</VpcId> 
        <HealthCheckIntervalSeconds>30</HealthCheckIntervalSeconds> 
        <LoadBalancerArns> 
          <member>arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188</member> 
        </LoadBalancerArns> 
        <UnhealthyThresholdCount>2</UnhealthyThresholdCount> 
      </member> 
    </TargetGroups> 
  </ModifyTargetGroupResult> 
  <ResponseMetadata> 
    <RequestId>8525b334-f466-11e5-aa04-33bf366f62e2</RequestId> 
  </ResponseMetadata> 
</ModifyTargetGroupResponse>
```

## See Also
<a name="API_ModifyTargetGroup_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/ModifyTargetGroup) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/ModifyTargetGroup) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/ModifyTargetGroup) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/ModifyTargetGroup) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/ModifyTargetGroup) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/ModifyTargetGroup) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/ModifyTargetGroup) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/ModifyTargetGroup) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/ModifyTargetGroup) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/ModifyTargetGroup) 

# ModifyTargetGroupAttributes
<a name="API_ModifyTargetGroupAttributes"></a>

Modifies the specified attributes of the specified target group.

## Request Parameters
<a name="API_ModifyTargetGroupAttributes_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **Attributes.member.N**   
The target group attributes.  
Type: Array of [TargetGroupAttribute](API_TargetGroupAttribute.md) objects  
Required: Yes

 ** TargetGroupArn **   
The Amazon Resource Name (ARN) of the target group.  
Type: String  
Required: Yes

## Response Elements
<a name="API_ModifyTargetGroupAttributes_ResponseElements"></a>

The following element is returned by the service.

 **Attributes.member.N**   
Information about the target group attributes.  
Type: Array of [TargetGroupAttribute](API_TargetGroupAttribute.md) objects

## Errors
<a name="API_ModifyTargetGroupAttributes_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidConfigurationRequest **   
The requested configuration is not valid.  
HTTP Status Code: 400

 ** TargetGroupNotFound **   
The specified target group does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_ModifyTargetGroupAttributes_Examples"></a>

### Modify the deregistration delay timeout
<a name="API_ModifyTargetGroupAttributes_Example_1"></a>

This example sets the deregistration delay timeout for the specified target group to the specified value.

#### Sample Request
<a name="API_ModifyTargetGroupAttributes_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=ModifyTargetGroupAttributes
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Attributes.member.1.Key=deregistration_delay.timeout_seconds
&Attributes.member.1.Value=600
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_ModifyTargetGroupAttributes_Example_1_Response"></a>

```
<ModifyTargetGroupAttributesResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <ModifyTargetGroupAttributesResult> 
    <Attributes> 
      <member> 
        <Value>600</Value> 
        <Key>deregistration_delay.timeout_seconds</Key> 
      </member> 
    </Attributes> 
  </ModifyTargetGroupAttributesResult> 
  <ResponseMetadata> 
    <RequestId>bb8c272b-f455-11e5-a53c-67205c0d10fd</RequestId> 
  </ResponseMetadata> 
</ModifyTargetGroupAttributesResponse>
```

## See Also
<a name="API_ModifyTargetGroupAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/ModifyTargetGroupAttributes) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/ModifyTargetGroupAttributes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/ModifyTargetGroupAttributes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/ModifyTargetGroupAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/ModifyTargetGroupAttributes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/ModifyTargetGroupAttributes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/ModifyTargetGroupAttributes) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/ModifyTargetGroupAttributes) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/ModifyTargetGroupAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/ModifyTargetGroupAttributes) 

# ModifyTrustStore
<a name="API_ModifyTrustStore"></a>

Update the ca certificate bundle for the specified trust store.

## Request Parameters
<a name="API_ModifyTrustStore_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** CaCertificatesBundleS3Bucket **   
The Amazon S3 bucket for the ca certificates bundle.  
Type: String  
Required: Yes

 ** CaCertificatesBundleS3Key **   
The Amazon S3 path for the ca certificates bundle.  
Type: String  
Required: Yes

 ** CaCertificatesBundleS3ObjectVersion **   
The Amazon S3 object version for the ca certificates bundle. If undefined the current version is used.  
Type: String  
Required: No

 ** TrustStoreArn **   
The Amazon Resource Name (ARN) of the trust store.  
Type: String  
Required: Yes

## Response Elements
<a name="API_ModifyTrustStore_ResponseElements"></a>

The following element is returned by the service.

 **TrustStores.member.N**   
Information about the modified trust store.  
Type: Array of [TrustStore](API_TrustStore.md) objects

## Errors
<a name="API_ModifyTrustStore_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** CaCertificatesBundleNotFound **   
The specified ca certificate bundle does not exist.  
HTTP Status Code: 400

 ** InvalidCaCertificatesBundle **   
The specified ca certificate bundle is in an invalid format, or corrupt.  
HTTP Status Code: 400

 ** TrustStoreNotFound **   
The specified trust store does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_ModifyTrustStore_Examples"></a>

### Modify a trust store.
<a name="API_ModifyTrustStore_Example_1"></a>

This example replaces the ca certificate bundle in the specified trust store.

#### Sample Request
<a name="API_ModifyTrustStore_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=ModifyTrustStore
&TrustStoreArn=arn:aws:elasticloadbalancing:us-east-1:111122223333:truststore/my-trust-store/d5f637c79df8c943
&CaCertificatesBundleS3Bucket=amzn-s3-demo-bucket
&CaCertificatesBundleS3Key=CACertBundle.pem
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_ModifyTrustStore_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/ModifyTrustStore) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/ModifyTrustStore) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/ModifyTrustStore) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/ModifyTrustStore) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/ModifyTrustStore) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/ModifyTrustStore) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/ModifyTrustStore) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/ModifyTrustStore) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/ModifyTrustStore) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/ModifyTrustStore) 

# RegisterTargets
<a name="API_RegisterTargets"></a>

Registers the specified targets with the specified target group.

If the target is an EC2 instance, it must be in the `running` state when you register it.

By default, the load balancer routes requests to registered targets using the protocol and port for the target group. Alternatively, you can override the port for a target when you register it. You can register each EC2 instance or IP address with the same target group multiple times using different ports.

For more information, see the following:
+  [Register targets for your Application Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/target-group-register-targets.html) 
+  [Register targets for your Network Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/target-group-register-targets.html) 
+  [Register targets for your Gateway Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/target-group-register-targets.html) 

To remove a target from a target group, use [DeregisterTargets](API_DeregisterTargets.md).

## Request Parameters
<a name="API_RegisterTargets_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** TargetGroupArn **   
The Amazon Resource Name (ARN) of the target group.  
Type: String  
Required: Yes

 **Targets.member.N**   
The targets.  
Type: Array of [TargetDescription](API_TargetDescription.md) objects  
Required: Yes

## Errors
<a name="API_RegisterTargets_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidTarget **   
The specified target does not exist, is not in the same VPC as the target group, or has an unsupported instance type.  
HTTP Status Code: 400

 ** TargetGroupNotFound **   
The specified target group does not exist.  
HTTP Status Code: 400

 ** TooManyRegistrationsForTargetId **   
You've reached the limit on the number of times a target can be registered with a load balancer.  
HTTP Status Code: 400

 ** TooManyTargets **   
You've reached the limit on the number of targets.  
HTTP Status Code: 400

## Examples
<a name="API_RegisterTargets_Examples"></a>

### Register targets by instance ID
<a name="API_RegisterTargets_Example_1"></a>

This example registers the specified instance IDs with the specified target group.

#### Sample Request
<a name="API_RegisterTargets_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=RegisterTargets
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Targets.member.1.Id=i-80c8dd94
&Targets.member.2.Id=i-ceddcd4d
&Version=2015-12-01
&AUTHPARAMS
```

### Register targets by IP address
<a name="API_RegisterTargets_Example_2"></a>

This example registers the specified IP addresses with the specified target group.

#### Sample Request
<a name="API_RegisterTargets_Example_2_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=RegisterTargets
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Targets.member.1.Id=10.0.42.17
&Targets.member.2.Id=192.168.0.3
&Targets.member.2.AvailabilityZone=all
&Version=2015-12-01
&AUTHPARAMS
```

### Register targets by instance ID using port overrides
<a name="API_RegisterTargets_Example_3"></a>

This example registers the specified instance with the specified target group using multiple ports. This enables you to register microservices on the same instance as targets in the target group.

#### Sample Request
<a name="API_RegisterTargets_Example_3_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=RegisterTargets
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Targets.member.1.Id=i-80c8dd94
&Targets.member.1.Port=80
&Targets.member.2.Id=i-80c8dd94
&Targets.member.2.Port=766
&Version=2015-12-01
&AUTHPARAMS
```

### Register a Lambda function as a target
<a name="API_RegisterTargets_Example_4"></a>

This example registers the specified Lambda function with the specified target group. You must grant Elastic Load Balancing permission to invoke the Lambda function. For more information, see [Lambda functions as targets](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/lambda-functions.html) in the *Application Load Balancers Guide*.

#### Sample Request
<a name="API_RegisterTargets_Example_4_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=RegisterTargets
&TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
&Targets.member.1.Id=aws:lambda:us-west-2:123456789012:function:my-function
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_RegisterTargets_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/RegisterTargets) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/RegisterTargets) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/RegisterTargets) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/RegisterTargets) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/RegisterTargets) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/RegisterTargets) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/RegisterTargets) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/RegisterTargets) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/RegisterTargets) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/RegisterTargets) 

# RemoveListenerCertificates
<a name="API_RemoveListenerCertificates"></a>

Removes the specified certificate from the certificate list for the specified HTTPS or TLS listener.

You can't remove the default certificate for a listener. To replace the default certificate, call [ModifyListener](API_ModifyListener.md).

To list the certificates for your listener, use [DescribeListenerCertificates](API_DescribeListenerCertificates.md).

## Request Parameters
<a name="API_RemoveListenerCertificates_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **Certificates.member.N**   
The certificate to remove. You can specify one certificate per call. Set `CertificateArn` to the certificate ARN but do not set `IsDefault`.  
Type: Array of [Certificate](API_Certificate.md) objects  
Required: Yes

 ** ListenerArn **   
The Amazon Resource Name (ARN) of the listener.  
Type: String  
Required: Yes

## Errors
<a name="API_RemoveListenerCertificates_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ListenerNotFound **   
The specified listener does not exist.  
HTTP Status Code: 400

 ** OperationNotPermitted **   
This operation is not allowed.  
HTTP Status Code: 400

## See Also
<a name="API_RemoveListenerCertificates_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/RemoveListenerCertificates) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/RemoveListenerCertificates) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/RemoveListenerCertificates) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/RemoveListenerCertificates) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/RemoveListenerCertificates) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/RemoveListenerCertificates) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/RemoveListenerCertificates) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/RemoveListenerCertificates) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/RemoveListenerCertificates) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/RemoveListenerCertificates) 

# RemoveTags
<a name="API_RemoveTags"></a>

Removes the specified tags from the specified Elastic Load Balancing resources. You can remove the tags for one or more Application Load Balancers, Network Load Balancers, Gateway Load Balancers, target groups, listeners, or rules.

To list the current tags for your resources, use [DescribeTags](API_DescribeTags.md).

## Request Parameters
<a name="API_RemoveTags_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **ResourceArns.member.N**   
The Amazon Resource Name (ARN) of the resource.  
Type: Array of strings  
Required: Yes

 **TagKeys.member.N**   
The tag keys for the tags to remove.  
Type: Array of strings  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`   
Required: Yes

## Errors
<a name="API_RemoveTags_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ListenerNotFound **   
The specified listener does not exist.  
HTTP Status Code: 400

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

 ** RuleNotFound **   
The specified rule does not exist.  
HTTP Status Code: 400

 ** TargetGroupNotFound **   
The specified target group does not exist.  
HTTP Status Code: 400

 ** TooManyTags **   
You've reached the limit on the number of tags for this resource.  
HTTP Status Code: 400

 ** TrustStoreNotFound **   
The specified trust store does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_RemoveTags_Examples"></a>

### Remove tags from a load balancer
<a name="API_RemoveTags_Example_1"></a>

This example removes the specified tags from the specified load balancer.

#### Sample Request
<a name="API_RemoveTags_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=RemoveTags
&ResourceArns.member.1=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&TagKeys.member.1=project
&TagKeys.member.2=department
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_RemoveTags_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/RemoveTags) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/RemoveTags) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/RemoveTags) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/RemoveTags) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/RemoveTags) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/RemoveTags) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/RemoveTags) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/RemoveTags) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/RemoveTags) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/RemoveTags) 

# RemoveTrustStoreRevocations
<a name="API_RemoveTrustStoreRevocations"></a>

Removes the specified revocation file from the specified trust store.

## Request Parameters
<a name="API_RemoveTrustStoreRevocations_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **RevocationIds.member.N**   
The revocation IDs of the revocation files you want to remove.  
Type: Array of longs  
Required: Yes

 ** TrustStoreArn **   
The Amazon Resource Name (ARN) of the trust store.  
Type: String  
Required: Yes

## Errors
<a name="API_RemoveTrustStoreRevocations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** RevocationIdNotFound **   
The specified revocation ID does not exist.  
HTTP Status Code: 400

 ** TrustStoreNotFound **   
The specified trust store does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_RemoveTrustStoreRevocations_Examples"></a>

### Remove a revocation file from a trust store.
<a name="API_RemoveTrustStoreRevocations_Example_1"></a>

This example removes the specified certificate revocation ID from the specified trust store.

#### Sample Request
<a name="API_RemoveTrustStoreRevocations_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=RemoveTrustStoreRevocations
&TrustStoreArn=arn:aws:elasticloadbalancing:us-east-1:111122223333:truststore/my-trust-store/3ym756xh7yj
&RevocationIds.member.1.RevocationID=1
&Version=2015-12-01
&AUTHPARAMS
```

## See Also
<a name="API_RemoveTrustStoreRevocations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/RemoveTrustStoreRevocations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/RemoveTrustStoreRevocations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/RemoveTrustStoreRevocations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/RemoveTrustStoreRevocations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/RemoveTrustStoreRevocations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/RemoveTrustStoreRevocations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/RemoveTrustStoreRevocations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/RemoveTrustStoreRevocations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/RemoveTrustStoreRevocations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/RemoveTrustStoreRevocations) 

# SetIpAddressType
<a name="API_SetIpAddressType"></a>

Sets the type of IP addresses used by the subnets of the specified load balancer.

## Request Parameters
<a name="API_SetIpAddressType_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** IpAddressType **   
The IP address type. Internal load balancers must use `ipv4`.  
[Application Load Balancers] The possible values are `ipv4` (IPv4 addresses), `dualstack` (IPv4 and IPv6 addresses), and `dualstack-without-public-ipv4` (public IPv6 addresses and private IPv4 and IPv6 addresses).  
Application Load Balancer authentication supports IPv4 addresses only when connecting to an Identity Provider (IdP) or Amazon Cognito endpoint. Without a public IPv4 address the load balancer can't complete the authentication process, resulting in HTTP 500 errors.  
[Network Load Balancers and Gateway Load Balancers] The possible values are `ipv4` (IPv4 addresses) and `dualstack` (IPv4 and IPv6 addresses).  
Type: String  
Valid Values: `ipv4 | dualstack | dualstack-without-public-ipv4`   
Required: Yes

 ** LoadBalancerArn **   
The Amazon Resource Name (ARN) of the load balancer.  
Type: String  
Required: Yes

## Response Elements
<a name="API_SetIpAddressType_ResponseElements"></a>

The following element is returned by the service.

 ** IpAddressType **   
The IP address type.  
Type: String  
Valid Values: `ipv4 | dualstack | dualstack-without-public-ipv4` 

## Errors
<a name="API_SetIpAddressType_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidConfigurationRequest **   
The requested configuration is not valid.  
HTTP Status Code: 400

 ** InvalidSubnet **   
The specified subnet is out of available addresses.  
HTTP Status Code: 400

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_SetIpAddressType_Examples"></a>

### Set the IP address type of a load balancer
<a name="API_SetIpAddressType_Example_1"></a>

This example sets the IP address type of the specified load balancer to `dualstack` to support IPv4 and IPv6 addresses. The load balancer subnets must have associated IPv6 CIDR blocks.

#### Sample Request
<a name="API_SetIpAddressType_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=SetIpAddressType
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&IpAddressType=dualstack
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_SetIpAddressType_Example_1_Response"></a>

```
<SetIpAddressTypeResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <SetIpAddressTypeResult>
    <IpAddressType>dualstack</IpAddressType>
  </SetIpAddressTypeResult> 
  <ResponseMetadata> 
    <RequestId>a127426b-f3ab-11e5-9192-3fff33344cfa</RequestId> 
  </ResponseMetadata> 
</SetIpAddressTypeResponse>
```

## See Also
<a name="API_SetIpAddressType_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/SetIpAddressType) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/SetIpAddressType) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/SetIpAddressType) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/SetIpAddressType) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/SetIpAddressType) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/SetIpAddressType) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/SetIpAddressType) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/SetIpAddressType) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/SetIpAddressType) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/SetIpAddressType) 

# SetRulePriorities
<a name="API_SetRulePriorities"></a>

Sets the priorities of the specified rules.

You can reorder the rules as long as there are no priority conflicts in the new order. Any existing rules that you do not specify retain their current priority.

## Request Parameters
<a name="API_SetRulePriorities_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 **RulePriorities.member.N**   
The rule priorities.  
Type: Array of [RulePriorityPair](API_RulePriorityPair.md) objects  
Required: Yes

## Response Elements
<a name="API_SetRulePriorities_ResponseElements"></a>

The following element is returned by the service.

 **Rules.member.N**   
Information about the rules.  
Type: Array of [Rule](API_Rule.md) objects

## Errors
<a name="API_SetRulePriorities_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** OperationNotPermitted **   
This operation is not allowed.  
HTTP Status Code: 400

 ** PriorityInUse **   
The specified priority is in use.  
HTTP Status Code: 400

 ** RuleNotFound **   
The specified rule does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_SetRulePriorities_Examples"></a>

### Set the rule priority
<a name="API_SetRulePriorities_Example_1"></a>

This example sets the priority of the specified rule.

#### Sample Request
<a name="API_SetRulePriorities_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=SetRulePriorities
&RulePriorities.member.1.RuleArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3
&RulePriorities.member.1.Priority=5
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_SetRulePriorities_Example_1_Response"></a>

```
<SetRulePrioritiesResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <SetRulePrioritiesResult> 
    <Rules> 
      <member> 
        <IsDefault>false</IsDefault> 
        <Conditions> 
          <member> 
            <Field>path-pattern</Field> 
            <Values> 
              <member>/img/*</member> 
            </Values> 
          </member> 
        </Conditions> 
        <Priority>5</Priority> 
        <Actions> 
          <member> 
            <Type>forward</Type> 
            <TargetGroupArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067</TargetGroupArn> 
          </member> 
        </Actions> 
        <RuleArn>arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3</RuleArn> 
      </member> 
    </Rules> 
  </SetRulePrioritiesResult> 
  <ResponseMetadata> 
    <RequestId>4d7a8036-f3a7-11e5-9c02-8fd20490d5a6</RequestId> 
  </ResponseMetadata> 
</SetRulePrioritiesResponse>
```

## See Also
<a name="API_SetRulePriorities_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/SetRulePriorities) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/SetRulePriorities) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/SetRulePriorities) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/SetRulePriorities) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/SetRulePriorities) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/SetRulePriorities) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/SetRulePriorities) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/SetRulePriorities) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/SetRulePriorities) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/SetRulePriorities) 

# SetSecurityGroups
<a name="API_SetSecurityGroups"></a>

Associates the specified security groups with the specified Application Load Balancer or Network Load Balancer. The specified security groups override the previously associated security groups.

You can't perform this operation on a Network Load Balancer unless you specified a security group for the load balancer when you created it.

You can't associate a security group with a Gateway Load Balancer.

## Request Parameters
<a name="API_SetSecurityGroups_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** EnforceSecurityGroupInboundRulesOnPrivateLinkTraffic **   
Indicates whether to evaluate inbound security group rules for traffic sent to a Network Load Balancer through AWS PrivateLink. Applies only if the load balancer has an associated security group. The default is `on`.  
Type: String  
Valid Values: `on | off`   
Required: No

 ** LoadBalancerArn **   
The Amazon Resource Name (ARN) of the load balancer.  
Type: String  
Required: Yes

 **SecurityGroups.member.N**   
The IDs of the security groups.  
Type: Array of strings  
Required: Yes

## Response Elements
<a name="API_SetSecurityGroups_ResponseElements"></a>

The following elements are returned by the service.

 ** EnforceSecurityGroupInboundRulesOnPrivateLinkTraffic **   
Indicates whether to evaluate inbound security group rules for traffic sent to a Network Load Balancer through AWS PrivateLink.  
Type: String  
Valid Values: `on | off` 

 **SecurityGroupIds.member.N**   
The IDs of the security groups associated with the load balancer.  
Type: Array of strings

## Errors
<a name="API_SetSecurityGroups_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidConfigurationRequest **   
The requested configuration is not valid.  
HTTP Status Code: 400

 ** InvalidSecurityGroup **   
The specified security group does not exist.  
HTTP Status Code: 400

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_SetSecurityGroups_Examples"></a>

### Associate a security group with a load balancer
<a name="API_SetSecurityGroups_Example_1"></a>

This example associates the specified security group with the specified load balancer.

#### Sample Request
<a name="API_SetSecurityGroups_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=SetSecurityGroups
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&SecurityGroups.member.1=sg-5943793c
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_SetSecurityGroups_Example_1_Response"></a>

```
<SetSecurityGroupsResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <SetSecurityGroupsResult> 
    <SecurityGroupIds> 
      <member>sg-5943793c</member> 
    </SecurityGroupIds> 
  </SetSecurityGroupsResult> 
  <ResponseMetadata> 
    <RequestId>a127426b-f3ab-11e5-9192-3fff33344cfa</RequestId> 
  </ResponseMetadata> 
</SetSecurityGroupsResponse>
```

## See Also
<a name="API_SetSecurityGroups_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 

# SetSubnets
<a name="API_SetSubnets"></a>

Enables the Availability Zones for the specified public subnets for the specified Application Load Balancer, Network Load Balancer or Gateway Load Balancer. The specified subnets replace the previously enabled subnets.

## Request Parameters
<a name="API_SetSubnets_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** EnablePrefixForIpv6SourceNat **   
[Network Load Balancers with UDP listeners] Indicates whether to use an IPv6 prefix from each subnet for source NAT. The IP address type must be `dualstack`. The default value is `off`.  
Type: String  
Valid Values: `on | off`   
Required: No

 ** IpAddressType **   
The IP address type.  
[Application Load Balancers] The possible values are `ipv4` (IPv4 addresses), `dualstack` (IPv4 and IPv6 addresses), and `dualstack-without-public-ipv4` (public IPv6 addresses and private IPv4 and IPv6 addresses).  
[Network Load Balancers and Gateway Load Balancers] The possible values are `ipv4` (IPv4 addresses) and `dualstack` (IPv4 and IPv6 addresses).  
Type: String  
Valid Values: `ipv4 | dualstack | dualstack-without-public-ipv4`   
Required: No

 ** LoadBalancerArn **   
The Amazon Resource Name (ARN) of the load balancer.  
Type: String  
Required: Yes

 **SubnetMappings.member.N**   
The IDs of the public subnets. You can specify only one subnet per Availability Zone. You must specify either subnets or subnet mappings.  
[Application Load Balancers] You must specify subnets from at least two Availability Zones. You can't specify Elastic IP addresses for your subnets.  
[Application Load Balancers on Outposts] You must specify one Outpost subnet.  
[Application Load Balancers on Local Zones] You can specify subnets from one or more Local Zones.  
[Network Load Balancers] You can specify subnets from one or more Availability Zones. You can specify one Elastic IP address per subnet if you need static IP addresses for your internet-facing load balancer. For internal load balancers, you can specify one private IP address per subnet from the IPv4 range of the subnet. For internet-facing load balancer, you can specify one IPv6 address per subnet.  
[Gateway Load Balancers] You can specify subnets from one or more Availability Zones.  
Type: Array of [SubnetMapping](API_SubnetMapping.md) objects  
Required: No

 **Subnets.member.N**   
The IDs of the public subnets. You can specify only one subnet per Availability Zone. You must specify either subnets or subnet mappings.  
[Application Load Balancers] You must specify subnets from at least two Availability Zones.  
[Application Load Balancers on Outposts] You must specify one Outpost subnet.  
[Application Load Balancers on Local Zones] You can specify subnets from one or more Local Zones.  
[Network Load Balancers] You can specify subnets from one or more Availability Zones.  
[Gateway Load Balancers] You can specify subnets from one or more Availability Zones. You must include all subnets that were enabled previously, with their existing configurations, plus any additional subnets.  
Type: Array of strings  
Required: No

## Response Elements
<a name="API_SetSubnets_ResponseElements"></a>

The following elements are returned by the service.

 **AvailabilityZones.member.N**   
Information about the subnets.  
Type: Array of [AvailabilityZone](API_AvailabilityZone.md) objects

 ** EnablePrefixForIpv6SourceNat **   
[Network Load Balancers] Indicates whether to use an IPv6 prefix from each subnet for source NAT.  
Type: String  
Valid Values: `on | off` 

 ** IpAddressType **   
The IP address type.  
Type: String  
Valid Values: `ipv4 | dualstack | dualstack-without-public-ipv4` 

## Errors
<a name="API_SetSubnets_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AllocationIdNotFound **   
The specified allocation ID does not exist.  
HTTP Status Code: 400

 ** AvailabilityZoneNotSupported **   
The specified Availability Zone is not supported.  
HTTP Status Code: 400

 ** CapacityReservationPending **   
There is a pending capacity reservation.  
HTTP Status Code: 400

 ** InvalidConfigurationRequest **   
The requested configuration is not valid.  
HTTP Status Code: 400

 ** InvalidSubnet **   
The specified subnet is out of available addresses.  
HTTP Status Code: 400

 ** LoadBalancerNotFound **   
The specified load balancer does not exist.  
HTTP Status Code: 400

 ** SubnetNotFound **   
The specified subnet does not exist.  
HTTP Status Code: 400

## Examples
<a name="API_SetSubnets_Examples"></a>

### Enable Availability Zones for a load balancer
<a name="API_SetSubnets_Example_1"></a>

This example enables the Availability Zone for the specified subnet for the specified load balancer.

#### Sample Request
<a name="API_SetSubnets_Example_1_Request"></a>

```
https://elasticloadbalancing.amazonaws.com/?Action=SetSubnets
&LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Subnets.member.1=subnet-8360a9e7
&Subnets.member.2=subnet-b7d581c0
&Version=2015-12-01
&AUTHPARAMS
```

#### Sample Response
<a name="API_SetSubnets_Example_1_Response"></a>

```
<SetSubnetsResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/">
  <SetSubnetsResult> 
    <AvailabilityZones> 
      <member> 
        <SubnetId>subnet-8360a9e7</SubnetId> 
        <ZoneName>us-west-2a</ZoneName> 
      </member> 
      <member> 
        <SubnetId>subnet-b7d581c0</SubnetId> 
        <ZoneName>us-west-2b</ZoneName> 
      </member> 
    </AvailabilityZones> 
  </SetSubnetsResult> 
  <ResponseMetadata> 
    <RequestId>c1a80803-f3ab-11e5-b673-8d4a8a9e6f48</RequestId> 
  </ResponseMetadata> 
</SetSubnetsResponse>
```

## See Also
<a name="API_SetSubnets_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/elasticloadbalancingv2-2015-12-01/SetSubnets) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/SetSubnets) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/SetSubnets) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/SetSubnets) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/SetSubnets) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/SetSubnets) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/SetSubnets) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/SetSubnets) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticloadbalancingv2-2015-12-01/SetSubnets) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/SetSubnets)