ModifyTargetGroup#

Description#

Request to create a target group.

Request Parameters#

Required parameters#

  • TargetGroupArn — The Amazon Resource Name (ARN) of the target group.

    • Type: String

    • Required: Yes

Optional parameters#

  • HealthCheckEnabled — Indicates whether health check is enabled.

    • Type: Boolean

    • Required: No

    • Valid values: True

    • Default value: True

  • HealthCheckIntervalSeconds — The amount of time between health checks of an individual target, in seconds.

    • Type: Integer

    • Required: No

    • Valid values: 10 | 30 for ELB of the type network; 5 to 300 for ELB of the type application

    • Default value: 30

  • HealthCheckProtocol — The HTTP path used to perform health checks on targets.

    • Type: String

    • Required: No

    • Valid values: /

    • Default value: /

  • HealthCheckPort — The port used to check target health. The traffic-port value means that the port, on which the target receives requests, is used for health checks.

    • Type: String

    • Required: No

    • Valid values: traffic-port

    • Default value: traffic-port

  • HealthCheckProtocol — The protocol used to perform health checks on targets.

    • Type: String

    • Required: No

    • Constraints: It must match the protocol used by the target group

    • Valid values: TCP | UDP | HTTP

  • HealthCheckTimeoutSeconds — The amount of time, after which no response from a target means a failed health check, in seconds.

    • Type: Integer

    • Required: No

    • Range: 2 to 120

    • Constraints: Cannot be changed for ELB of the network type

    • Default value: 10 for ELB of the type network, 5 for ELF of the type application

  • HealthyThresholdCount — Number of successful health checks after which the target status changes to healthy.

    • Type: Integer

    • Required: No

    • Valid range: From 2 to 10

    • Constraints: For ELB of the type network, the value must match the value of UnhealthyThresholdCount

    • Default value: 3 for TCP and UDP target groups, 5 for HTTP target groups

  • Matcher — The HTTP codes to use when checking for a successful response from a target.

    • Type: :ref: Matcher object

    • Required: No

    • Default value: 200

  • UnhealthyThresholdCount — Number of unsuccessful health checks after which the target status changes to unhealthy.

    • Type: Integer

    • Required: No

    • Valid range: From 2 to 10

    • Constraints: For ELB of the type network, the value must match the value of HealthyThresholdCount

    • Default value: 3 for TCP and UDP target groups, 2 for HTTP target groups

Response Elements#

  • TargetGroups.N — Information about target groups.

Examples#

c2-elb ModifyTargetGroup TargetGroupArn "tg_arn" HealthCheckIntervalSeconds 10

c2-elb ModifyTargetGroup TargetGroupArn "tg_arn" UnhealthyThresholdCount 5 HealthyThresholdCount 5