software.amazon.awscdk.services.elasticloadbalancingv2

Class NetworkListenerAction

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.services.elasticloadbalancingv2.NetworkListenerAction

All Implemented Interfaces:

IListenerAction

@Generated(value="jsii-pacmak/1.73.0 (build 6faeda3)",
           date="2023-01-31T18:36:57.677Z")
public class NetworkListenerAction
extends software.amazon.jsii.JsiiObject
implements IListenerAction

What to do when a client makes a request to a listener.

Some actions can be combined with other ones (specifically, you can perform authentication before serving the request).

Multiple actions form a linked chain; the chain must always terminate in a (weighted)forward, fixedResponse or redirect action.

If an action supports chaining, the next action can be indicated by passing it in the next property.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.elasticloadbalancingv2.*;
 import software.amazon.awscdk.core.*;
 NetworkTargetGroup networkTargetGroup;
 NetworkListenerAction networkListenerAction = NetworkListenerAction.forward(List.of(networkTargetGroup), NetworkForwardOptions.builder()
         .stickinessDuration(Duration.minutes(30))
         .build());
 

Nested Class Summary

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.elasticloadbalancingv2.IListenerAction

IListenerAction.Jsii$Default, IListenerAction.Jsii$Proxy

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	NetworkListenerAction(CfnListener.ActionProperty actionJson, NetworkListenerAction next) Create an instance of NetworkListenerAction.
protected	NetworkListenerAction(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	NetworkListenerAction(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
void	bind(Construct scope, INetworkListener listener) Called when the action is being used in a listener.
static NetworkListenerAction	forward(java.util.List<? extends INetworkTargetGroup> targetGroups) Forward to one or more Target Groups.
static NetworkListenerAction	forward(java.util.List<? extends INetworkTargetGroup> targetGroups, NetworkForwardOptions options) Forward to one or more Target Groups.
protected NetworkListenerAction	getNext()
java.util.List<CfnListener.ActionProperty>	renderActions() Render the actions in this chain.
protected java.util.List<CfnListener.ActionProperty>	renumber(java.util.List<CfnListener.ActionProperty> actions) Renumber the "order" fields in the actions array.
static NetworkListenerAction	weightedForward(java.util.List<? extends NetworkWeightedTargetGroup> targetGroups) Forward to one or more Target Groups which are weighted differently.
static NetworkListenerAction	weightedForward(java.util.List<? extends NetworkWeightedTargetGroup> targetGroups, NetworkForwardOptions options) Forward to one or more Target Groups which are weighted differently.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NetworkListenerAction

protected NetworkListenerAction(software.amazon.jsii.JsiiObjectRef objRef)

NetworkListenerAction

protected NetworkListenerAction(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

NetworkListenerAction

protected NetworkListenerAction(CfnListener.ActionProperty actionJson,
                                NetworkListenerAction next)

Create an instance of NetworkListenerAction.

The default class should be good enough for most cases and should be created by using one of the static factory functions, but allow overriding to make sure we allow flexibility for the future.

Parameters:

actionJson - This parameter is required.

next -

Method Detail

forward

public static NetworkListenerAction forward(java.util.List<? extends INetworkTargetGroup> targetGroups,
                                            NetworkForwardOptions options)

Forward to one or more Target Groups.

Parameters:

targetGroups - This parameter is required.

options -

forward

public static NetworkListenerAction forward(java.util.List<? extends INetworkTargetGroup> targetGroups)

Forward to one or more Target Groups.

Parameters:

targetGroups - This parameter is required.

weightedForward

public static NetworkListenerAction weightedForward(java.util.List<? extends NetworkWeightedTargetGroup> targetGroups,
                                                    NetworkForwardOptions options)

Forward to one or more Target Groups which are weighted differently.

Parameters:

targetGroups - This parameter is required.

options -

weightedForward

public static NetworkListenerAction weightedForward(java.util.List<? extends NetworkWeightedTargetGroup> targetGroups)

Forward to one or more Target Groups which are weighted differently.

Parameters:

targetGroups - This parameter is required.

bind

public void bind(Construct scope,
                 INetworkListener listener)

Called when the action is being used in a listener.

Parameters:

scope - This parameter is required.

listener - This parameter is required.

renderActions

public java.util.List<CfnListener.ActionProperty> renderActions()

Render the actions in this chain.

Specified by:

renderActions in interface IListenerAction

renumber

protected java.util.List<CfnListener.ActionProperty> renumber(java.util.List<CfnListener.ActionProperty> actions)

Renumber the "order" fields in the actions array.

We don't number for 0 or 1 elements, but otherwise number them 1...#actions so ELB knows about the right order.

Do this in NetworkListenerAction instead of in Listener so that we give users the opportunity to override by subclassing and overriding renderActions.

Parameters:

actions - This parameter is required.

getNext

protected NetworkListenerAction getNext()