AWS SDK Version 3 for .NET
API Reference

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.

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.

Note:

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 BeginModifyListener and EndModifyListener.

Namespace: Amazon.ElasticLoadBalancingV2
Assembly: AWSSDK.ElasticLoadBalancingV2.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<ModifyListenerResponse> ModifyListenerAsync(
         ModifyListenerRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.ElasticLoadBalancingV2.Model.ModifyListenerRequest

Container for the necessary parameters to execute the ModifyListener service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the ModifyListener service method, as returned by ElasticLoadBalancingV2.

Exceptions

ExceptionCondition
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.
ListenerNotFoundException The specified listener 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.
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.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also