Class ApplicationTargetGroup

Define an Application Target Group.

Inheritance

System.Object

Construct

TargetGroupBase

ApplicationTargetGroup

Implements

IApplicationTargetGroup

ITargetGroup

IConstruct

IDependable

Inherited Members

TargetGroupBase.AddLoadBalancerTarget(ILoadBalancerTargetProps)

TargetGroupBase.ConfigureHealthCheck(IHealthCheck)

TargetGroupBase.SetAttribute(String, String)

TargetGroupBase.DefaultPort

TargetGroupBase.LoadBalancerArns

TargetGroupBase.LoadBalancerAttached

TargetGroupBase.LoadBalancerAttachedDependencies

TargetGroupBase.TargetGroupArn

TargetGroupBase.TargetGroupFullName

TargetGroupBase.TargetGroupLoadBalancerArns

TargetGroupBase.TargetGroupName

TargetGroupBase.HealthCheck

TargetGroupBase.TargetType

Construct.IsConstruct(Object)

Construct.Prepare()

Construct.Synthesize(ISynthesisSession)

Construct.ToString()

Construct.Node

Namespace: Amazon.CDK.AWS.ElasticLoadBalancingV2

Assembly: Amazon.CDK.AWS.ElasticLoadBalancingV2.dll

Syntax (csharp)

public class ApplicationTargetGroup : TargetGroupBase, IApplicationTargetGroup, ITargetGroup, IConstruct, IDependable

Syntax (vb)

Public Class ApplicationTargetGroup
    Inherits TargetGroupBase
    Implements IApplicationTargetGroup, ITargetGroup, IConstruct, IDependable

Remarks

Stability: Stable

Synopsis

Constructors

ApplicationTargetGroup(Construct, String, IApplicationTargetGroupProps)
ApplicationTargetGroup(ByRefValue)	Used by jsii to construct an instance of this class from a Javascript-owned object reference
ApplicationTargetGroup(DeputyBase.DeputyProps)	Used by jsii to construct an instance of this class from DeputyProps

Properties

FirstLoadBalancerFullName

Full name of first load balancer.

Methods

AddTarget(IApplicationLoadBalancerTarget[])	Add a load balancing target to this target group.
EnableCookieStickiness(Duration)	Enable sticky routing via a cookie to members of this target group.
FromTargetGroupAttributes(Construct, String, ITargetGroupAttributes)	Import an existing target group.
Import(Construct, String, ITargetGroupImportProps)	Import an existing target group.
Metric(String, IMetricOptions)	Return the given named metric for this Application Load Balancer Target Group.
MetricHealthyHostCount(IMetricOptions)	The number of healthy hosts in the target group.
MetricHttpCodeTarget(HttpCodeTarget, IMetricOptions)	The number of HTTP 2xx/3xx/4xx/5xx response codes generated by all targets in this target group.
MetricIpv6RequestCount(IMetricOptions)	The number of IPv6 requests received by the target group.
MetricRequestCount(IMetricOptions)	The number of requests processed over IPv4 and IPv6.
MetricRequestCountPerTarget(IMetricOptions)	The average number of requests received by each target in a target group.
MetricTargetConnectionErrorCount(IMetricOptions)	The number of connections that were not successfully established between the load balancer and target.
MetricTargetResponseTime(IMetricOptions)	The time elapsed, in seconds, after the request leaves the load balancer until a response from the target is received.
MetricTargetTLSNegotiationErrorCount(IMetricOptions)	The number of TLS connections initiated by the load balancer that did not establish a session with the target.
MetricUnhealthyHostCount(IMetricOptions)	The number of unhealthy hosts in the target group.
RegisterConnectable(IConnectable, Port)	Register a connectable as a member of this target group.
RegisterListener(IApplicationListener, IConstruct)	Register a listener that is load balancing to this target group.
Validate()	Validate the current construct.

Constructors

ApplicationTargetGroup(Construct, String, IApplicationTargetGroupProps)

public ApplicationTargetGroup(Construct scope, string id, IApplicationTargetGroupProps props = null)

Parameters

scope Construct
id System.String
props IApplicationTargetGroupProps

Remarks

Stability: Stable

ApplicationTargetGroup(ByRefValue)

Used by jsii to construct an instance of this class from a Javascript-owned object reference

protected ApplicationTargetGroup(ByRefValue reference)

Parameters

reference Amazon.JSII.Runtime.Deputy.ByRefValue: The Javascript-owned object reference

ApplicationTargetGroup(DeputyBase.DeputyProps)

Used by jsii to construct an instance of this class from DeputyProps

protected ApplicationTargetGroup(DeputyBase.DeputyProps props)

Parameters

props Amazon.JSII.Runtime.Deputy.DeputyBase.DeputyProps: The deputy props

Properties

FirstLoadBalancerFullName

Full name of first load balancer.

public override string FirstLoadBalancerFullName { get; }

Property Value

System.String

Overrides

TargetGroupBase.FirstLoadBalancerFullName

Remarks

Stability: Stable

Methods

AddTarget(IApplicationLoadBalancerTarget[])

Add a load balancing target to this target group.

public virtual void AddTarget(params IApplicationLoadBalancerTarget[] targets)

Parameters

targets IApplicationLoadBalancerTarget[]

Remarks

Stability: Stable

EnableCookieStickiness(Duration)

Enable sticky routing via a cookie to members of this target group.

public virtual void EnableCookieStickiness(Duration duration)

Parameters

duration Duration

Remarks

Stability: Stable

FromTargetGroupAttributes(Construct, String, ITargetGroupAttributes)

Import an existing target group.

public static IApplicationTargetGroup FromTargetGroupAttributes(Construct scope, string id, ITargetGroupAttributes attrs)

Parameters

scope Construct
id System.String
attrs ITargetGroupAttributes

Returns

IApplicationTargetGroup

Remarks

Stability: Stable

Import(Construct, String, ITargetGroupImportProps)

Import an existing target group.

public static IApplicationTargetGroup Import(Construct scope, string id, ITargetGroupImportProps props)

Parameters

scope Construct
id System.String
props ITargetGroupImportProps

Returns

IApplicationTargetGroup

Remarks

Stability: Deprecated

Metric(String, IMetricOptions)

Return the given named metric for this Application Load Balancer Target Group.

public virtual Metric Metric(string metricName, IMetricOptions props = null)

Parameters

metricName System.String
props IMetricOptions

Returns

Metric

Remarks

Returns the metric for this target group from the point of view of the first load balancer load balancing to it. If you have multiple load balancers load sending traffic to the same target group, you will have to override the dimensions on this metric.

Default: Average over 5 minutes

Stability: Stable

MetricHealthyHostCount(IMetricOptions)

The number of healthy hosts in the target group.

public virtual Metric MetricHealthyHostCount(IMetricOptions props = null)

Parameters

props IMetricOptions

Returns

Metric

Remarks

Default: Average over 5 minutes

Stability: Stable

MetricHttpCodeTarget(HttpCodeTarget, IMetricOptions)

The number of HTTP 2xx/3xx/4xx/5xx response codes generated by all targets in this target group.

public virtual Metric MetricHttpCodeTarget(HttpCodeTarget code, IMetricOptions props = null)

Parameters

code HttpCodeTarget
props IMetricOptions

Returns

Metric

Remarks

This does not include any response codes generated by the load balancer.

Default: Sum over 5 minutes

Stability: Stable

MetricIpv6RequestCount(IMetricOptions)

The number of IPv6 requests received by the target group.

public virtual Metric MetricIpv6RequestCount(IMetricOptions props = null)

Parameters

props IMetricOptions

Returns

Metric

Remarks

Default: Sum over 5 minutes

Stability: Stable

MetricRequestCount(IMetricOptions)

The number of requests processed over IPv4 and IPv6.

public virtual Metric MetricRequestCount(IMetricOptions props = null)

Parameters

props IMetricOptions

Returns

Metric

Remarks

This count includes only the requests with a response generated by a target of the load balancer.

Default: Sum over 5 minutes

Stability: Stable

MetricRequestCountPerTarget(IMetricOptions)

The average number of requests received by each target in a target group.

public virtual Metric MetricRequestCountPerTarget(IMetricOptions props = null)

Parameters

props IMetricOptions

Returns

Metric

Remarks

The only valid statistic is Sum. Note that this represents the average not the sum.

Default: Sum over 5 minutes

Stability: Stable

MetricTargetConnectionErrorCount(IMetricOptions)

The number of connections that were not successfully established between the load balancer and target.

public virtual Metric MetricTargetConnectionErrorCount(IMetricOptions props = null)

Parameters

props IMetricOptions

Returns

Metric

Remarks

Default: Sum over 5 minutes

Stability: Stable

MetricTargetResponseTime(IMetricOptions)

The time elapsed, in seconds, after the request leaves the load balancer until a response from the target is received.

public virtual Metric MetricTargetResponseTime(IMetricOptions props = null)

Parameters

props IMetricOptions

Returns

Metric

Remarks

Default: Average over 5 minutes

Stability: Stable

MetricTargetTLSNegotiationErrorCount(IMetricOptions)

The number of TLS connections initiated by the load balancer that did not establish a session with the target.

public virtual Metric MetricTargetTLSNegotiationErrorCount(IMetricOptions props = null)

Parameters

props IMetricOptions

Returns

Metric

Remarks

Possible causes include a mismatch of ciphers or protocols.

Default: Sum over 5 minutes

Stability: Stable

MetricUnhealthyHostCount(IMetricOptions)

The number of unhealthy hosts in the target group.

public virtual Metric MetricUnhealthyHostCount(IMetricOptions props = null)

Parameters

props IMetricOptions

Returns

Metric

Remarks

Default: Average over 5 minutes

Stability: Stable

RegisterConnectable(IConnectable, Port)

public virtual void RegisterConnectable(IConnectable connectable, Port portRange = null)

Parameters

connectable IConnectable
portRange Port

Remarks

Don't call this directly. It will be called by load balancing targets.

Stability: Stable

RegisterListener(IApplicationListener, IConstruct)

public virtual void RegisterListener(IApplicationListener listener, IConstruct associatingConstruct = null)

Parameters

listener IApplicationListener
associatingConstruct IConstruct

Remarks

Don't call this directly. It will be called by listeners.

Stability: Stable

Validate()

Validate the current construct.

protected override string[] Validate()

Returns

System.String[]

Overrides

TargetGroupBase.Validate()

Remarks

This method can be implemented by derived constructs in order to perform validation logic. It is called on all constructs before synthesis.

Stability: Stable

Implements

IApplicationTargetGroup

ITargetGroup

IConstruct

IDependable