Skip to content
v2.277.0

TargetGroupHealth Struct ​

Properties for configuring a target group health.

Example ​

ts
declare const vpc: ec2.Vpc;

const targetGroup = new elbv2.ApplicationTargetGroup(this, 'TargetGroup', {
  vpc,
  port: 80,
  targetGroupHealth: {
    dnsMinimumHealthyTargetCount: 3,
    dnsMinimumHealthyTargetPercentage: 70,
    routingMinimumHealthyTargetCount: 2,
    routingMinimumHealthyTargetPercentage: 50,
  },
});
python
# vpc: ec2.Vpc


target_group = elbv2.ApplicationTargetGroup(self, "TargetGroup",
    vpc=vpc,
    port=80,
    target_group_health=elbv2.TargetGroupHealth(
        dns_minimum_healthy_target_count=3,
        dns_minimum_healthy_target_percentage=70,
        routing_minimum_healthy_target_count=2,
        routing_minimum_healthy_target_percentage=50
    )
)
java
Vpc vpc;


ApplicationTargetGroup targetGroup = ApplicationTargetGroup.Builder.create(this, "TargetGroup")
        .vpc(vpc)
        .port(80)
        .targetGroupHealth(TargetGroupHealth.builder()
                .dnsMinimumHealthyTargetCount(3)
                .dnsMinimumHealthyTargetPercentage(70)
                .routingMinimumHealthyTargetCount(2)
                .routingMinimumHealthyTargetPercentage(50)
                .build())
        .build();
csharp
// Install: dotnet add package Amazon.CDK.Lib
Vpc vpc;


var targetGroup = new ApplicationTargetGroup(this, "TargetGroup", new ApplicationTargetGroupProps {
    Vpc = vpc,
    Port = 80,
    TargetGroupHealth = new TargetGroupHealth {
        DnsMinimumHealthyTargetCount = 3,
        DnsMinimumHealthyTargetPercentage = 70,
        RoutingMinimumHealthyTargetCount = 2,
        RoutingMinimumHealthyTargetPercentage = 50
    }
});
go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
var vpc Vpc


targetGroup := elbv2.NewApplicationTargetGroup(this, jsii.String("TargetGroup"), &ApplicationTargetGroupProps{
	Vpc: Vpc,
	Port: jsii.Number(80),
	TargetGroupHealth: &TargetGroupHealth{
		DnsMinimumHealthyTargetCount: jsii.Number(3),
		DnsMinimumHealthyTargetPercentage: jsii.Number(70),
		RoutingMinimumHealthyTargetCount: jsii.Number(2),
		RoutingMinimumHealthyTargetPercentage: jsii.Number(50),
	},
})

Properties ​

dnsMinimumHealthyTargetCountoptionalnumberdns_minimum_healthy_target_countoptionalint | floatdnsMinimumHealthyTargetCountoptionalNumberDnsMinimumHealthyTargetCountoptionaldoubleDnsMinimumHealthyTargetCountoptional*float64= 1#
The minimum number of targets that must be healthy for DNS failover.

If below this value, mark the zone as unhealthy in DNS. Use 0 for "off".

dnsMinimumHealthyTargetPercentageoptionalnumberdns_minimum_healthy_target_percentageoptionalint | floatdnsMinimumHealthyTargetPercentageoptionalNumberDnsMinimumHealthyTargetPercentageoptionaldoubleDnsMinimumHealthyTargetPercentageoptional*float64= 0#
The minimum percentage of targets that must be healthy for DNS failover.

If below this value, mark the zone as unhealthy in DNS. Use 0 for "off".

routingMinimumHealthyTargetCountoptionalnumberrouting_minimum_healthy_target_countoptionalint | floatroutingMinimumHealthyTargetCountoptionalNumberRoutingMinimumHealthyTargetCountoptionaldoubleRoutingMinimumHealthyTargetCountoptional*float64= 1#
The minimum number of targets that must be healthy for unhealthy state routing.

If below this value, send traffic to all targets including unhealthy ones.

routingMinimumHealthyTargetPercentageoptionalnumberrouting_minimum_healthy_target_percentageoptionalint | floatroutingMinimumHealthyTargetPercentageoptionalNumberRoutingMinimumHealthyTargetPercentageoptionaldoubleRoutingMinimumHealthyTargetPercentageoptional*float64= 0#
The minimum percentage of targets that must be healthy for unhealthy state routing.

If below this value, send traffic to all targets including unhealthy ones. Use 0 for "off".