software.amazon.awscdk.services.elasticloadbalancingv2

Class NetworkListenerAction

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.services.elasticloadbalancingv2.NetworkListenerAction

All Implemented Interfaces:

IListenerAction, software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/1.29.0 (build 41df200)",
           date="2021-06-02T09:55:29.973Z")
 @Stability(value=Experimental)
public class NetworkListenerAction
extends software.amazon.jsii.JsiiObject
implements IListenerAction

(experimental) 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.

Nested Class Summary

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

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) (experimental) Create an instance of NetworkListenerAction.
protected	NetworkListenerAction(CfnListener.ActionProperty actionJson, NetworkListenerAction next) (experimental) 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(software.constructs.Construct scope, INetworkListener listener) (experimental) Called when the action is being used in a listener.
static NetworkListenerAction	forward(List<? extends INetworkTargetGroup> targetGroups) (experimental) Forward to one or more Target Groups.
static NetworkListenerAction	forward(List<? extends INetworkTargetGroup> targetGroups, NetworkForwardOptions options) (experimental) Forward to one or more Target Groups.
protected NetworkListenerAction	getNext()
List<CfnListener.ActionProperty>	renderActions() (experimental) Render the actions in this chain.
protected List<CfnListener.ActionProperty>	renumber(List<CfnListener.ActionProperty> actions) (experimental) Renumber the "order" fields in the actions array.
static NetworkListenerAction	weightedForward(List<? extends NetworkWeightedTargetGroup> targetGroups) (experimental) Forward to one or more Target Groups which are weighted differently.
static NetworkListenerAction	weightedForward(List<? extends NetworkWeightedTargetGroup> targetGroups, NetworkForwardOptions options) (experimental) Forward to one or more Target Groups which are weighted differently.

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

NetworkListenerAction

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

NetworkListenerAction

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

NetworkListenerAction

@Stability(value=Experimental)
protected NetworkListenerAction(@NotNull
                                                               CfnListener.ActionProperty actionJson,
                                                               @Nullable
                                                               NetworkListenerAction next)

(experimental) 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 -

NetworkListenerAction

@Stability(value=Experimental)
protected NetworkListenerAction(@NotNull
                                                               CfnListener.ActionProperty actionJson)

(experimental) 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.

Method Detail

forward

@Stability(value=Experimental)
 @NotNull
public static NetworkListenerAction forward(@NotNull
                                                                                     List<? extends INetworkTargetGroup> targetGroups,
                                                                                     @Nullable
                                                                                     NetworkForwardOptions options)

(experimental) Forward to one or more Target Groups.

Parameters:

targetGroups - This parameter is required.

options -

forward

@Stability(value=Experimental)
 @NotNull
public static NetworkListenerAction forward(@NotNull
                                                                                     List<? extends INetworkTargetGroup> targetGroups)

(experimental) Forward to one or more Target Groups.

Parameters:

targetGroups - This parameter is required.

weightedForward

@Stability(value=Experimental)
 @NotNull
public static NetworkListenerAction weightedForward(@NotNull
                                                                                             List<? extends NetworkWeightedTargetGroup> targetGroups,
                                                                                             @Nullable
                                                                                             NetworkForwardOptions options)

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

Parameters:

targetGroups - This parameter is required.

options -

weightedForward

@Stability(value=Experimental)
 @NotNull
public static NetworkListenerAction weightedForward(@NotNull
                                                                                             List<? extends NetworkWeightedTargetGroup> targetGroups)

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

Parameters:

targetGroups - This parameter is required.

bind

@Stability(value=Experimental)
public void bind(@NotNull
                                                software.constructs.Construct scope,
                                                @NotNull
                                                INetworkListener listener)

(experimental) Called when the action is being used in a listener.

Parameters:

scope - This parameter is required.

listener - This parameter is required.

renderActions

@Stability(value=Experimental)
 @NotNull
public List<CfnListener.ActionProperty> renderActions()

(experimental) Render the actions in this chain.

Specified by:

renderActions in interface IListenerAction

renumber

@Stability(value=Experimental)
 @NotNull
protected List<CfnListener.ActionProperty> renumber(@NotNull
                                                                                             List<CfnListener.ActionProperty> actions)

(experimental) 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

@Stability(value=Experimental)
 @Nullable
protected NetworkListenerAction getNext()