AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Creates a listener for the specified Application Load Balancer, Network Load Balancer, or Gateway Load Balancer.
For more information, see the following:
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.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginCreateListener and EndCreateListener.
Namespace: Amazon.ElasticLoadBalancingV2
Assembly: AWSSDK.ElasticLoadBalancingV2.dll
Version: 3.x.y.z
public virtual Task<CreateListenerResponse> CreateListenerAsync( CreateListenerRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the CreateListener service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
| Exception | Condition |
|---|---|
| ALPNPolicyNotSupportedException | The specified ALPN policy is not supported. |
| CertificateNotFoundException | The specified certificate does not exist. |
| DuplicateListenerException | A listener with the specified port already exists. |
| IncompatibleProtocolsException | The specified configuration is not valid with this protocol. |
| InvalidConfigurationRequestException | The requested configuration is not valid. |
| InvalidLoadBalancerActionException | The requested action is not valid. |
| LoadBalancerNotFoundException | The specified load balancer does not exist. |
| SSLPolicyNotFoundException | The specified SSL policy does not exist. |
| TargetGroupAssociationLimitException | You've reached the limit on the number of load balancers per target group. |
| TargetGroupNotFoundException | The specified target group does not exist. |
| TooManyActionsException | You've reached the limit on the number of actions per rule. |
| TooManyCertificatesException | You've reached the limit on the number of certificates per load balancer. |
| TooManyListenersException | You've reached the limit on the number of listeners per load balancer. |
| TooManyRegistrationsForTargetIdException | You've reached the limit on the number of times a target can be registered with a load balancer. |
| TooManyTagsException | You've reached the limit on the number of tags for this resource. |
| TooManyTargetsException | You've reached the limit on the number of targets. |
| TooManyUniqueTargetGroupsPerLoadBalancerException | 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. |
| TrustStoreNotFoundException | The specified trust store does not exist. |
| TrustStoreNotReadyException | The specified trust store is not active. |
| UnsupportedProtocolException | The specified protocol is not supported. |
.NET Core App:
Supported in: 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5