Na}{

File Content: `describe-target-health.rst`

**To describe the health of the targets for a target group**

This example describes the health of the targets for the specified target group. These targets are healthy.

Command::

  aws elbv2 describe-target-health --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067

Output::

  {
    "TargetHealthDescriptions": [
        {
            "HealthCheckPort": "80",
            "Target": {
                "Id": "i-ceddcd4d",
                "Port": 80
            },
            "TargetHealth": {
                "State": "healthy"
            }
        },
        {
            "HealthCheckPort": "80",
            "Target": {
                "Id": "i-0f76fade",
                "Port": 80
            },
            "TargetHealth": {
                "State": "healthy"
            }
        }
    ]
  }

**To describe the health of a target**

This example describes the health of the specified target. This target is healthy.

Command::

  aws elbv2 describe-target-health --targets Id=i-0f76fade,Port=80 --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067

Output::

  {
    "TargetHealthDescriptions": [
        {
            "HealthCheckPort": "80",
            "Target": {
                "Id": "i-0f76fade",
                "Port": 80
            },
            "TargetHealth": {
                "State": "healthy"
            }
        }
    ]
  }

The following is an example response for a target whose target group is not specified in an action for a listener. This target can't receive traffic from the load balancer.

Output::

  {
    "TargetHealthDescriptions": [
        {
            "Target": {
                "Id": "i-0f76fade",
                "Port": 80
            },
            "TargetHealth": {
                "State": "unused",
                "Reason": "Target.NotInUse",
                "Description": "Given target group is not configured to receive traffic from ELB"
            }
        }
    ]
  }

The following is an example response for a target who target group was just specified in an action for a listener. The target is still being registered.

Output::

  {
    "TargetHealthDescriptions": [
        {
            "Target": {
                "Id": "i-0f76fade",
                "Port": 80
            },
            "TargetHealth": {
                "State": "initial",
                "Reason": "Elb.RegistrationInProgress",
                "Description": "Target registration is in progress"
            }
        }
    ]
  }

The following is an example response for an unhealthy target.

Output::

  {
    "TargetHealthDescriptions": [
        {
            "Target": {
                "Id": "i-0f76fade",
                "Port": 80
            },
            "TargetHealth": {
                "State": "unhealthy",
                "Reason": "Target.Timeout",
                "Description": "Connection to target timed out"
            }
        }
    ]
  }

Name	Size	Permission
add-tags.rst	333 bytes	0755
create-listener.rst	3050 bytes	0755
create-load-balancer.rst	2735 bytes	0755
create-rule.rst	1303 bytes	0755
create-target-group.rst	1039 bytes	0755
delete-listener.rst	249 bytes	0755
delete-load-balancer.rst	256 bytes	0755
delete-rule.rst	255 bytes	0755
delete-target-group.rst	241 bytes	0755
deregister-targets.rst	680 bytes	0755
describe-listeners.rst	2772 bytes	0755
describe-load-balancer-attributes.rst	842 bytes	0755
describe-load-balancers.rst	1469 bytes	0755
describe-rules.rst	2700 bytes	0755
describe-ssl-policies.rst	1240 bytes	0755
describe-tags.rst	785 bytes	0755
describe-target-group-attributes.rst	752 bytes	0755
describe-target-groups.rst	1597 bytes	0755
describe-target-health.rst	3144 bytes	0755
modify-listener.rst	2413 bytes	0755
modify-load-balancer-attributes.rst	2940 bytes	0755
modify-rule.rst	1097 bytes	0755
modify-target-group-attributes.rst	858 bytes	0755
modify-target-group.rst	1291 bytes	0755
register-targets.rst	811 bytes	0755
remove-tags.rst	307 bytes	0755
set-rule-priorities.rst	1078 bytes	0755
set-security-groups.rst	428 bytes	0755
set-subnets.rst	631 bytes	0755

File Content: describe-target-health.rst

File Content: `describe-target-health.rst`