Skip to content

Commit fea922c

Browse files
author
awstools
committed
docs(client-elastic-load-balancing-v2): This release adds two attributes for ALB. One, helps to preserve the host header and the other helps to modify, preserve, or remove the X-Forwarded-For header in the HTTP request.
1 parent 1737bf6 commit fea922c

File tree

4 files changed

+57
-22
lines changed

4 files changed

+57
-22
lines changed

clients/client-elastic-load-balancing-v2/src/ElasticLoadBalancingV2.ts

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1175,6 +1175,8 @@ export class ElasticLoadBalancingV2 extends ElasticLoadBalancingV2Client {
11751175
/**
11761176
* <p>Modifies the health checks used when evaluating the health state of the targets in the
11771177
* specified target group.</p>
1178+
* <p>If the protocol of the target group is TCP, TLS, UDP, or TCP_UDP, you can't modify the
1179+
* health check protocol, interval, timeout, or success codes.</p>
11781180
*/
11791181
public modifyTargetGroup(
11801182
args: ModifyTargetGroupCommandInput,

clients/client-elastic-load-balancing-v2/src/commands/ModifyTargetGroupCommand.ts

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,8 @@ export interface ModifyTargetGroupCommandOutput extends ModifyTargetGroupOutput,
2929
/**
3030
* <p>Modifies the health checks used when evaluating the health state of the targets in the
3131
* specified target group.</p>
32+
* <p>If the protocol of the target group is TCP, TLS, UDP, or TCP_UDP, you can't modify the
33+
* health check protocol, interval, timeout, or success codes.</p>
3234
* @example
3335
* Use a bare-bones client and the command you need to make an API call.
3436
* ```javascript

clients/client-elastic-load-balancing-v2/src/models/models_0.ts

Lines changed: 43 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1380,7 +1380,8 @@ export interface CreateLoadBalancerInput {
13801380

13811381
/**
13821382
* <p>The IDs of the public subnets. You can specify only one subnet per Availability Zone. You
1383-
* must specify either subnets or subnet mappings.</p>
1383+
* must specify either subnets or subnet mappings, but not both. To specify an Elastic IP
1384+
* address, specify subnet mappings instead of subnets.</p>
13841385
* <p>[Application Load Balancers] You must specify subnets from at least two Availability
13851386
* Zones.</p>
13861387
* <p>[Application Load Balancers on Outposts] You must specify one Outpost subnet.</p>
@@ -1395,7 +1396,7 @@ export interface CreateLoadBalancerInput {
13951396

13961397
/**
13971398
* <p>The IDs of the public subnets. You can specify only one subnet per Availability Zone. You
1398-
* must specify either subnets or subnet mappings.</p>
1399+
* must specify either subnets or subnet mappings, but not both.</p>
13991400
* <p>[Application Load Balancers] You must specify subnets from at least two Availability
14001401
* Zones. You cannot specify Elastic IP addresses for your subnets.</p>
14011402
* <p>[Application Load Balancers on Outposts] You must specify one Outpost subnet.</p>
@@ -1967,7 +1968,8 @@ export namespace SourceIpConditionConfig {
19671968
* <p>Each rule can optionally include up to one of each of the following conditions:
19681969
* <code>http-request-method</code>, <code>host-header</code>, <code>path-pattern</code>, and
19691970
* <code>source-ip</code>. Each rule can also optionally include one or more of each of the
1970-
* following conditions: <code>http-header</code> and <code>query-string</code>.</p>
1971+
* following conditions: <code>http-header</code> and <code>query-string</code>. Note that the
1972+
* value for a condition cannot be empty.</p>
19711973
*/
19721974
export interface RuleCondition {
19731975
/**
@@ -2375,10 +2377,11 @@ export interface CreateTargetGroupInput {
23752377

23762378
/**
23772379
* <p>The approximate amount of time, in seconds, between health checks of an individual target.
2380+
* If the target group protocol is HTTP or HTTPS, the default is 30 seconds.
23782381
* If the target group protocol is TCP, TLS, UDP, or TCP_UDP, the supported values are 10 and 30
2379-
* seconds. If the target group protocol is HTTP or HTTPS, the default is 30 seconds. If the
2380-
* target group protocol is GENEVE, the default is 10 seconds. If the target type is
2381-
* <code>lambda</code>, the default is 35 seconds.</p>
2382+
* seconds and the default is 30 seconds.
2383+
* If the target group protocol is GENEVE, the default is 10 seconds.
2384+
* If the target type is <code>lambda</code>, the default is 35 seconds.</p>
23822385
*/
23832386
HealthCheckIntervalSeconds?: number;
23842387

@@ -3114,9 +3117,9 @@ export interface LoadBalancerAttribute {
31143117
* </li>
31153118
* <li>
31163119
* <p>
3117-
* <code>ipv6.deny-all-igw-traffic</code> - Blocks internet gateway (IGW) access to the
3120+
* <code>ipv6.deny_all_igw_traffic</code> - Blocks internet gateway (IGW) access to the
31183121
* load balancer. It is set to <code>false</code> for internet-facing load balancers and
3119-
* <code>true</code> for internal load balancers, preventing unintended access to your
3122+
* <code>true</code> for internal load balancers, preventing unintended access to your
31203123
* internal load balancer through an internet gateway.</p>
31213124
* </li>
31223125
* </ul>
@@ -3143,6 +3146,13 @@ export interface LoadBalancerAttribute {
31433146
* </li>
31443147
* <li>
31453148
* <p>
3149+
* <code>routing.http.preserve_host_header.enabled</code> - Indicates whether the
3150+
* Application Load Balancer should preserve the <code>Host</code> header in the HTTP request
3151+
* and send it to the target without any change. The possible values are <code>true</code>
3152+
* and <code>false</code>. The default is <code>false</code>.</p>
3153+
* </li>
3154+
* <li>
3155+
* <p>
31463156
* <code>routing.http.x_amzn_tls_version_and_cipher_suite.enabled</code> - Indicates
31473157
* whether the two headers (<code>x-amzn-tls-version</code> and
31483158
* <code>x-amzn-tls-cipher-suite</code>), which contain information about the negotiated
@@ -3162,6 +3172,31 @@ export interface LoadBalancerAttribute {
31623172
* </li>
31633173
* <li>
31643174
* <p>
3175+
* <code>routing.http.xff_header_processing.mode</code> - Enables you to modify,
3176+
* preserve, or remove the <code>X-Forwarded-For</code> header in the HTTP request before the
3177+
* Application Load Balancer sends the request to the target. The possible values are
3178+
* <code>append</code>, <code>preserve</code>, and <code>remove</code>. The default is
3179+
* <code>append</code>.</p>
3180+
* <ul>
3181+
* <li>
3182+
* <p>If the value is <code>append</code>, the Application Load Balancer adds the client
3183+
* IP address (of the last hop) to the <code>X-Forwarded-For</code> header in the HTTP
3184+
* request before it sends it to targets.</p>
3185+
* </li>
3186+
* <li>
3187+
* <p>If the value is <code>preserve</code> the Application Load Balancer preserves the
3188+
* <code>X-Forwarded-For</code> header in the HTTP request, and sends it to targets
3189+
* without any change.</p>
3190+
* </li>
3191+
* <li>
3192+
* <p>If the value is <code>remove</code>, the Application Load Balancer removes the
3193+
* <code>X-Forwarded-For</code> header in the HTTP request before it sends it to
3194+
* targets.</p>
3195+
* </li>
3196+
* </ul>
3197+
* </li>
3198+
* <li>
3199+
* <p>
31653200
* <code>routing.http2.enabled</code> - Indicates whether HTTP/2 is enabled. The possible
31663201
* values are <code>true</code> and <code>false</code>. The default is <code>true</code>.
31673202
* Elastic Load Balancing requires that message header names contain only alphanumeric
@@ -4125,7 +4160,6 @@ export interface ModifyTargetGroupInput {
41254160
* protocol of the target group is HTTP or HTTPS. It is supported for health checks only if the
41264161
* protocol of the target group is TCP, TLS, UDP, or TCP_UDP. The GENEVE, TLS, UDP, and TCP_UDP
41274162
* protocols are not supported for health checks.</p>
4128-
* <p>With Network Load Balancers, you can't modify this setting.</p>
41294163
*/
41304164
HealthCheckProtocol?: ProtocolEnum | string;
41314165

@@ -4150,14 +4184,12 @@ export interface ModifyTargetGroupInput {
41504184
/**
41514185
* <p>The approximate amount of time, in seconds, between health checks of an individual target.
41524186
* For TCP health checks, the supported values are 10 or 30 seconds.</p>
4153-
* <p>With Network Load Balancers, you can't modify this setting.</p>
41544187
*/
41554188
HealthCheckIntervalSeconds?: number;
41564189

41574190
/**
41584191
* <p>[HTTP/HTTPS health checks] The amount of time, in seconds, during which no response means
41594192
* a failed health check.</p>
4160-
* <p>With Network Load Balancers, you can't modify this setting.</p>
41614193
*/
41624194
HealthCheckTimeoutSeconds?: number;
41634195

@@ -4177,7 +4209,6 @@ export interface ModifyTargetGroupInput {
41774209
/**
41784210
* <p>[HTTP/HTTPS health checks] The HTTP or gRPC codes to use when checking for a successful
41794211
* response from a target.</p>
4180-
* <p>With Network Load Balancers, you can't modify this setting.</p>
41814212
*/
41824213
Matcher?: Matcher;
41834214
}

0 commit comments

Comments
 (0)