software.amazon.awscdk.services.elasticloadbalancingv2

Class NetworkLoadBalancer

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.elasticloadbalancingv2.BaseLoadBalancer

software.amazon.awscdk.services.elasticloadbalancingv2.NetworkLoadBalancer

All Implemented Interfaces:

IResource, IVpcEndpointServiceLoadBalancer, ILoadBalancerV2, INetworkLoadBalancer, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.30.0 (build adae23f)",
           date="2021-06-30T10:01:19.817Z")
 @Stability(value=Experimental)
public class NetworkLoadBalancer
extends BaseLoadBalancer
implements INetworkLoadBalancer

(experimental) Define a new network load balancer.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NetworkLoadBalancer.Builder (experimental) A fluent builder for NetworkLoadBalancer.

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.INetworkLoadBalancer

INetworkLoadBalancer.Jsii$Default, INetworkLoadBalancer.Jsii$Proxy

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
NetworkListener	addListener(String id, BaseNetworkListenerProps props) (experimental) Add a listener to this load balancer.
static INetworkLoadBalancer	fromLookup(software.constructs.Construct scope, String id, NetworkLoadBalancerLookupOptions options) (experimental) Looks up the network load balancer.
static INetworkLoadBalancer	fromNetworkLoadBalancerAttributes(software.constructs.Construct scope, String id, NetworkLoadBalancerAttributes attrs)
void	logAccessLogs(IBucket bucket) (experimental) Enable access logging for this load balancer.
void	logAccessLogs(IBucket bucket, String prefix) (experimental) Enable access logging for this load balancer.
Metric	metric(String metricName) (experimental) Return the given named metric for this Network Load Balancer.
Metric	metric(String metricName, MetricOptions props) (experimental) Return the given named metric for this Network Load Balancer.
Metric	metricActiveFlowCount() (experimental) The total number of concurrent TCP flows (or connections) from clients to targets.
Metric	metricActiveFlowCount(MetricOptions props) (experimental) The total number of concurrent TCP flows (or connections) from clients to targets.
Metric	metricConsumedLCUs() (experimental) The number of load balancer capacity units (LCU) used by your load balancer.
Metric	metricConsumedLCUs(MetricOptions props) (experimental) The number of load balancer capacity units (LCU) used by your load balancer.
Metric	metricNewFlowCount() (experimental) The total number of new TCP flows (or connections) established from clients to targets in the time period.
Metric	metricNewFlowCount(MetricOptions props) (experimental) The total number of new TCP flows (or connections) established from clients to targets in the time period.
Metric	metricProcessedBytes() (experimental) The total number of bytes processed by the load balancer, including TCP/IP headers.
Metric	metricProcessedBytes(MetricOptions props) (experimental) The total number of bytes processed by the load balancer, including TCP/IP headers.
Metric	metricTcpClientResetCount() (experimental) The total number of reset (RST) packets sent from a client to a target.
Metric	metricTcpClientResetCount(MetricOptions props) (experimental) The total number of reset (RST) packets sent from a client to a target.
Metric	metricTcpElbResetCount() (experimental) The total number of reset (RST) packets generated by the load balancer.
Metric	metricTcpElbResetCount(MetricOptions props) (experimental) The total number of reset (RST) packets generated by the load balancer.
Metric	metricTcpTargetResetCount() (experimental) The total number of reset (RST) packets sent from a target to a client.
Metric	metricTcpTargetResetCount(MetricOptions props) (experimental) The total number of reset (RST) packets sent from a target to a client.

Methods inherited from class software.amazon.awscdk.services.elasticloadbalancingv2.BaseLoadBalancer

getLoadBalancerArn, getLoadBalancerCanonicalHostedZoneId, getLoadBalancerDnsName, getLoadBalancerFullName, getLoadBalancerName, getLoadBalancerSecurityGroups, getVpc, removeAttribute, setAttribute, setAttribute

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, 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.services.elasticloadbalancingv2.INetworkLoadBalancer

getVpc

Methods inherited from interface software.amazon.awscdk.services.elasticloadbalancingv2.ILoadBalancerV2

getLoadBalancerCanonicalHostedZoneId, getLoadBalancerDnsName

Methods inherited from interface software.amazon.awscdk.IResource

getEnv, getStack

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Methods inherited from interface software.amazon.awscdk.services.ec2.IVpcEndpointServiceLoadBalancer

getLoadBalancerArn

Constructor Detail

NetworkLoadBalancer

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

NetworkLoadBalancer

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

NetworkLoadBalancer

@Stability(value=Experimental)
public NetworkLoadBalancer(@NotNull
                                                          software.constructs.Construct scope,
                                                          @NotNull
                                                          String id,
                                                          @NotNull
                                                          NetworkLoadBalancerProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

fromLookup

@Stability(value=Experimental)
 @NotNull
public static INetworkLoadBalancer fromLookup(@NotNull
                                                                                       software.constructs.Construct scope,
                                                                                       @NotNull
                                                                                       String id,
                                                                                       @NotNull
                                                                                       NetworkLoadBalancerLookupOptions options)

(experimental) Looks up the network load balancer.

Parameters:

scope - This parameter is required.

id - This parameter is required.

options - This parameter is required.

fromNetworkLoadBalancerAttributes

@Stability(value=Experimental)
 @NotNull
public static INetworkLoadBalancer fromNetworkLoadBalancerAttributes(@NotNull
                                                                                                              software.constructs.Construct scope,
                                                                                                              @NotNull
                                                                                                              String id,
                                                                                                              @NotNull
                                                                                                              NetworkLoadBalancerAttributes attrs)

Parameters:

scope - This parameter is required.

id - This parameter is required.

attrs - This parameter is required.

addListener

@Stability(value=Experimental)
 @NotNull
public NetworkListener addListener(@NotNull
                                                                            String id,
                                                                            @NotNull
                                                                            BaseNetworkListenerProps props)

(experimental) Add a listener to this load balancer.

Specified by:

addListener in interface INetworkLoadBalancer

Parameters:

id - This parameter is required.

props - This parameter is required.

Returns:

The newly created listener

logAccessLogs

@Stability(value=Experimental)
public void logAccessLogs(@NotNull
                                                         IBucket bucket,
                                                         @Nullable
                                                         String prefix)

(experimental) Enable access logging for this load balancer.

A region must be specified on the stack containing the load balancer; you cannot enable logging on environment-agnostic stacks. See https://docs.aws.amazon.com/cdk/latest/guide/environments.html

This is extending the BaseLoadBalancer.logAccessLogs method to match the bucket permissions described at https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-access-logs.html#access-logging-bucket-requirements

Overrides:

logAccessLogs in class BaseLoadBalancer

Parameters:

bucket - This parameter is required.

prefix -

logAccessLogs

@Stability(value=Experimental)
public void logAccessLogs(@NotNull
                                                         IBucket bucket)

(experimental) Enable access logging for this load balancer.

A region must be specified on the stack containing the load balancer; you cannot enable logging on environment-agnostic stacks. See https://docs.aws.amazon.com/cdk/latest/guide/environments.html

This is extending the BaseLoadBalancer.logAccessLogs method to match the bucket permissions described at https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-access-logs.html#access-logging-bucket-requirements

Overrides:

logAccessLogs in class BaseLoadBalancer

Parameters:

bucket - This parameter is required.

metric

@Stability(value=Experimental)
 @NotNull
public Metric metric(@NotNull
                                                              String metricName,
                                                              @Nullable
                                                              MetricOptions props)

(experimental) Return the given named metric for this Network Load Balancer.

Default: Average over 5 minutes

Parameters:

metricName - This parameter is required.

props -

metric

@Stability(value=Experimental)
 @NotNull
public Metric metric(@NotNull
                                                              String metricName)

(experimental) Return the given named metric for this Network Load Balancer.

Default: Average over 5 minutes

Parameters:

metricName - This parameter is required.

metricActiveFlowCount

@Stability(value=Experimental)
 @NotNull
public Metric metricActiveFlowCount(@Nullable
                                                                             MetricOptions props)

(experimental) The total number of concurrent TCP flows (or connections) from clients to targets.

This metric includes connections in the SYN_SENT and ESTABLISHED states. TCP connections are not terminated at the load balancer, so a client opening a TCP connection to a target counts as a single flow.

Default: Average over 5 minutes

Parameters:

props -

metricActiveFlowCount

@Stability(value=Experimental)
 @NotNull
public Metric metricActiveFlowCount()

(experimental) The total number of concurrent TCP flows (or connections) from clients to targets.

This metric includes connections in the SYN_SENT and ESTABLISHED states. TCP connections are not terminated at the load balancer, so a client opening a TCP connection to a target counts as a single flow.

Default: Average over 5 minutes

metricConsumedLCUs

@Stability(value=Experimental)
 @NotNull
public Metric metricConsumedLCUs(@Nullable
                                                                          MetricOptions props)

(experimental) The number of load balancer capacity units (LCU) used by your load balancer.

Default: Sum over 5 minutes

Parameters:

props -

metricConsumedLCUs

@Stability(value=Experimental)
 @NotNull
public Metric metricConsumedLCUs()

(experimental) The number of load balancer capacity units (LCU) used by your load balancer.

Default: Sum over 5 minutes

metricNewFlowCount

@Stability(value=Experimental)
 @NotNull
public Metric metricNewFlowCount(@Nullable
                                                                          MetricOptions props)

(experimental) The total number of new TCP flows (or connections) established from clients to targets in the time period.

Default: Sum over 5 minutes

Parameters:

props -

metricNewFlowCount

@Stability(value=Experimental)
 @NotNull
public Metric metricNewFlowCount()

(experimental) The total number of new TCP flows (or connections) established from clients to targets in the time period.

Default: Sum over 5 minutes

metricProcessedBytes

@Stability(value=Experimental)
 @NotNull
public Metric metricProcessedBytes(@Nullable
                                                                            MetricOptions props)

(experimental) The total number of bytes processed by the load balancer, including TCP/IP headers.

Default: Sum over 5 minutes

Parameters:

props -

metricProcessedBytes

@Stability(value=Experimental)
 @NotNull
public Metric metricProcessedBytes()

(experimental) The total number of bytes processed by the load balancer, including TCP/IP headers.

Default: Sum over 5 minutes

metricTcpClientResetCount

@Stability(value=Experimental)
 @NotNull
public Metric metricTcpClientResetCount(@Nullable
                                                                                 MetricOptions props)

(experimental) The total number of reset (RST) packets sent from a client to a target.

These resets are generated by the client and forwarded by the load balancer.

Default: Sum over 5 minutes

Parameters:

props -

metricTcpClientResetCount

@Stability(value=Experimental)
 @NotNull
public Metric metricTcpClientResetCount()

(experimental) The total number of reset (RST) packets sent from a client to a target.

These resets are generated by the client and forwarded by the load balancer.

Default: Sum over 5 minutes

metricTcpElbResetCount

@Stability(value=Experimental)
 @NotNull
public Metric metricTcpElbResetCount(@Nullable
                                                                              MetricOptions props)

(experimental) The total number of reset (RST) packets generated by the load balancer.

Default: Sum over 5 minutes

Parameters:

props -

metricTcpElbResetCount

@Stability(value=Experimental)
 @NotNull
public Metric metricTcpElbResetCount()

(experimental) The total number of reset (RST) packets generated by the load balancer.

Default: Sum over 5 minutes

metricTcpTargetResetCount

@Stability(value=Experimental)
 @NotNull
public Metric metricTcpTargetResetCount(@Nullable
                                                                                 MetricOptions props)

(experimental) The total number of reset (RST) packets sent from a target to a client.

These resets are generated by the target and forwarded by the load balancer.

Default: Sum over 5 minutes

Parameters:

props -

metricTcpTargetResetCount

@Stability(value=Experimental)
 @NotNull
public Metric metricTcpTargetResetCount()

(experimental) The total number of reset (RST) packets sent from a target to a client.

These resets are generated by the target and forwarded by the load balancer.

Default: Sum over 5 minutes