Table Of Contents


User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . elbv2 ]



Modifies the specified attributes of the specified target group.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.


--target-group-arn <value>
--attributes <value>
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]


--target-group-arn (string)

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

--attributes (list)

The attributes.

Shorthand Syntax:

Key=string,Value=string ...

JSON Syntax:

    "Key": "string",
    "Value": "string"

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.


To modify the deregistration delay timeout

This example sets the deregistration delay timeout to the specified value for the specified target group.


aws elbv2 modify-target-group-attributes --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 --attributes Key=deregistration_delay.timeout_seconds,Value=600


  "Attributes": [
          "Value": "false",
          "Key": "stickiness.enabled"
          "Value": "600",
          "Key": "deregistration_delay.timeout_seconds"
          "Value": "lb_cookie",
          "Key": "stickiness.type"
          "Value": "86400",
          "Key": "stickiness.lb_cookie.duration_seconds"


Attributes -> (list)

Information about the attributes.


Information about a target group attribute.

Key -> (string)

The name of the attribute.

The following attributes are supported by both Application Load Balancers and Network Load Balancers:

  • deregistration_delay.timeout_seconds - The amount of time, in seconds, for Elastic Load Balancing to wait before changing the state of a deregistering target from draining to unused . The range is 0-3600 seconds. The default value is 300 seconds. If the target is a Lambda function, this attribute is not supported.
  • stickiness.enabled - Indicates whether sticky sessions are enabled. The value is true or false . The default is false .
  • stickiness.type - The type of sticky sessions. The possible values are lb_cookie for Application Load Balancers or source_ip for Network Load Balancers.

The following attributes are supported by Application Load Balancers if the target is not a Lambda function:

  • load_balancing.algorithm.type - The load balancing algorithm determines how the load balancer selects targets when routing requests. The value is round_robin or least_outstanding_requests . The default is round_robin .
  • slow_start.duration_seconds - The time period, in seconds, during which a newly registered target receives a linearly increasing share of the traffic to the target group. After this time period ends, the target receives its full share of traffic. The range is 30-900 seconds (15 minutes). Slow start mode is disabled by default.
  • stickiness.lb_cookie.duration_seconds - The time period, in seconds, during which requests from a client should be routed to the same target. After this time period expires, the load balancer-generated cookie is considered stale. The range is 1 second to 1 week (604800 seconds). The default value is 1 day (86400 seconds).

The following attribute is supported only if the target is a Lambda function.

  • lambda.multi_value_headers.enabled - Indicates whether the request and response headers exchanged between the load balancer and the Lambda function include arrays of values or strings. The value is true or false . The default is false . If the value is false and the request contains a duplicate header field name or query parameter key, the load balancer uses the last value sent by the client.

The following attribute is supported only by Network Load Balancers:

  • proxy_protocol_v2.enabled - Indicates whether Proxy Protocol version 2 is enabled. The value is true or false . The default is false .

Value -> (string)

The value of the attribute.