software.amazon.awscdk.services.globalaccelerator

Class Listener

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.globalaccelerator.Listener

All Implemented Interfaces:

IResource, IListener, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:39.517Z")
 @Stability(value=Stable)
public class Listener
extends Resource
implements IListener

The construct for the Listener.

Example:

 // Create an Accelerator
 Accelerator accelerator = new Accelerator(this, "Accelerator");
 // Create a Listener
 Listener listener = accelerator.addListener("Listener", ListenerOptions.builder()
         .portRanges(List.of(PortRange.builder().fromPort(80).build(), PortRange.builder().fromPort(443).build()))
         .build());
 // Import the Load Balancers
 INetworkLoadBalancer nlb1 = NetworkLoadBalancer.fromNetworkLoadBalancerAttributes(this, "NLB1", NetworkLoadBalancerAttributes.builder()
         .loadBalancerArn("arn:aws:elasticloadbalancing:us-west-2:111111111111:loadbalancer/app/my-load-balancer1/e16bef66805b")
         .build());
 INetworkLoadBalancer nlb2 = NetworkLoadBalancer.fromNetworkLoadBalancerAttributes(this, "NLB2", NetworkLoadBalancerAttributes.builder()
         .loadBalancerArn("arn:aws:elasticloadbalancing:ap-south-1:111111111111:loadbalancer/app/my-load-balancer2/5513dc2ea8a1")
         .build());
 // Add one EndpointGroup for each Region we are targeting
 listener.addEndpointGroup("Group1", EndpointGroupOptions.builder()
         .endpoints(List.of(new NetworkLoadBalancerEndpoint(nlb1)))
         .build());
 listener.addEndpointGroup("Group2", EndpointGroupOptions.builder()
         // Imported load balancers automatically calculate their Region from the ARN.
         // If you are load balancing to other resources, you must also pass a `region`
         // parameter here.
         .endpoints(List.of(new NetworkLoadBalancerEndpoint(nlb2)))
         .build());
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Listener.Builder A fluent builder for Listener.

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.globalaccelerator.IListener

IListener.Jsii$Default, IListener.Jsii$Proxy

Constructor Summary

Constructors

Modifier	Constructor and Description
	Listener(software.constructs.Construct scope, String id, ListenerProps props)
protected	Listener(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Listener(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
EndpointGroup	addEndpointGroup(String id) Add a new endpoint group to this listener.
EndpointGroup	addEndpointGroup(String id, EndpointGroupOptions options) Add a new endpoint group to this listener.
static IListener	fromListenerArn(software.constructs.Construct scope, String id, String listenerArn) import from ARN.
String	getListenerArn() The ARN of the listener.
String	getListenerName() The name of the listener.

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isOwnedResource, isResource

Methods inherited from class software.constructs.Construct

getNode, isConstruct, toString

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, wait, wait, wait

Methods inherited from interface software.amazon.awscdk.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

Listener

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

Listener

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

Listener

@Stability(value=Stable)
public Listener(@NotNull
                                         software.constructs.Construct scope,
                                         @NotNull
                                         String id,
                                         @NotNull
                                         ListenerProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

fromListenerArn

@Stability(value=Stable)
 @NotNull
public static IListener fromListenerArn(@NotNull
                                                                           software.constructs.Construct scope,
                                                                           @NotNull
                                                                           String id,
                                                                           @NotNull
                                                                           String listenerArn)

import from ARN.

Parameters:

scope - This parameter is required.

id - This parameter is required.

listenerArn - This parameter is required.

addEndpointGroup

@Stability(value=Stable)
 @NotNull
public EndpointGroup addEndpointGroup(@NotNull
                                                                         String id,
                                                                         @Nullable
                                                                         EndpointGroupOptions options)

Add a new endpoint group to this listener.

Parameters:

id - This parameter is required.

options -

addEndpointGroup

@Stability(value=Stable)
 @NotNull
public EndpointGroup addEndpointGroup(@NotNull
                                                                         String id)

Add a new endpoint group to this listener.

Parameters:

id - This parameter is required.

getListenerArn

@Stability(value=Stable)
 @NotNull
public String getListenerArn()

The ARN of the listener.

Specified by:

getListenerArn in interface IListener

getListenerName

@Stability(value=Stable)
 @NotNull
public String getListenerName()

The name of the listener.