DescribeTargetGroups#

Description#

Request to get the list of target groups.

Request Parameters#

  • LoadBalancerArn — The Amazon Resource Name (ARN) of the load balancer.

    • Type: Strings

    • Required: No

    • Constraints: Cannot be used with the TargetGroupArns and Names options

  • Marker — The NextMarker value from the previous call (see Response Elements).

    • Type: String

    • Required: No

  • Names.N — Names of target groups.

    • Type: Array of strings

    • Required: No

    • Constraints: Cannot be used with the LoadBalancerArn and TargetGroupArns options

  • PageSize — The limit on the number of returned target groups.

    • Type: Integer

    • Required: No

    • Default value: 400

    • Maximum value: 400

  • TargetGroupArns.N — List of Amazon Resource Names (ARN) of target groups.

    • Type: Array of strings

    • Required: No

    • Constraints: Cannot be used with the LoadBalancerArn and Names options

Response Elements#

  • TargetGroups.N — Information about target groups.

  • NextMarkerNextMarker is only returned after failure to return the list of all target groups meeting the specified criteria. To continue data output, the received value must be passed in the Marker parameter in the repeated request.

    Type: String

Examples#

c2-elb DescribeTargetGroups Names.1 "tgname"

c2-elb DescribeTargetGroups LoadBalancerArn "elb_arn"

c2-elb DescribeTargetGroups TargetGroupArns.1 "tg_arn_1" TargetGroupArns.2 "tg_arn_2"