AWS Security ChangesHomeSearch

AWS elasticloadbalancing: Document HTTP/2 RST_STREAM error forwarding target group attribute

Service: elasticloadbalancing · 2026-10-06 · Documentation low

File: elasticloadbalancing/latest/application/edit-target-group-attributes.md

Summary

Adds documentation for a new target group attribute (routing.http2.rst_stream_error_forwarding.enabled) that forwards HTTP/2/gRPC RST_STREAM error codes to clients instead of returning 502, with console, CLI, and CloudFormation instructions.

Security assessment

This documents a functional routing/error-handling feature for HTTP/2 and gRPC target groups. It changes error propagation behavior but does not address a vulnerability, credential, encryption, or authorization concern.

Evidence

When you enable RST_STREAM error forwarding, the load balancer instead forwards the target's `RST_STREAM` error code to the downstream client for the following error codes: `REFUSED_STREAM`, `CANCEL`, `ENHANCE_YOUR_CALM`, and `INTERNAL_ERROR`.

Diff

diff --git a/elasticloadbalancing/latest/application/edit-target-group-attributes.md b/elasticloadbalancing/latest/application/edit-target-group-attributes.md
index 3a9034b..d714a8d 100644
--- a//elasticloadbalancing/latest/application/edit-target-group-attributes.md
+++ b//elasticloadbalancing/latest/application/edit-target-group-attributes.md
@@ -7 +7 @@
-Deregistration delayRouting algorithmSlow start modeHealth settingsCross-zone load balancingAutomatic Target Weights (ATW)Sticky sessionsWAF HTTP/2 traffic inspection behavior
+Deregistration delayRouting algorithmSlow start modeHealth settingsCross-zone load balancingAutomatic Target Weights (ATW)Sticky sessionsWAF HTTP/2 traffic inspection behaviorHTTP/2 RST_STREAM error forwarding
@@ -30,0 +31,2 @@ After you create a target group for you Application Load Balancer, you can edit
+  * HTTP/2 RST_STREAM error forwarding
+
@@ -963,0 +966,60 @@ Update the [AWS::ElasticLoadBalancingV2::TargetGroup](https://docs.aws.amazon.co
+## HTTP/2 RST_STREAM error forwarding
+
+By default, when an HTTP/2 or gRPC target ends a stream by sending an `RST_STREAM` frame with an error, the load balancer returns an HTTP 502 (Bad Gateway) response to the client. This hides the specific error that the target reported.
+
+When you enable RST_STREAM error forwarding, the load balancer instead forwards the target's `RST_STREAM` error code to the downstream client for the following error codes: `REFUSED_STREAM`, `CANCEL`, `ENHANCE_YOUR_CALM`, and `INTERNAL_ERROR`. This lets gRPC and HTTP/2 clients observe and react to the exact error that the target returned. This attribute applies only to target groups that use the `HTTP2` or `GRPC` protocol version, and it is disabled by default.
+
+Console
+    
+
+###### To configure HTTP/2 RST_STREAM error forwarding
+
+  1. Open the Amazon EC2 console at [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
+
+  2. On the navigation pane, under **Load Balancing** , choose **Target Groups**.
+
+  3. Choose the name of the target group to open its details page.
+
+  4. On the **Attributes** tab, choose **Edit**.
+
+  5. For **HTTP/2 RST_STREAM error forwarding** , turn the setting on or off.
+
+  6. Choose **Save changes**.
+
+
+
+
+AWS CLI
+    
+
+###### To configure HTTP/2 RST_STREAM error forwarding
+
+Use the [modify-target-group-attributes](https://docs.aws.amazon.com/cli/latest/reference/elbv2/modify-target-group-attributes.html) command with the `routing.http2.rst_stream_error_forwarding.enabled` attribute.
+    
+    
+    aws elbv2 modify-target-group-attributes \
+        --target-group-arn target-group-arn \
+        --attributes "Key=routing.http2.rst_stream_error_forwarding.enabled,Value=true"
+
+CloudFormation
+    
+
+###### To configure HTTP/2 RST_STREAM error forwarding
+
+Update the [AWS::ElasticLoadBalancingV2::TargetGroup](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticloadbalancingv2-targetgroup.html) resource to include the `routing.http2.rst_stream_error_forwarding.enabled` attribute.
+    
+    
+    Resources:
+      myTargetGroup:
+        Type: 'AWS::ElasticLoadBalancingV2::TargetGroup'
+        Properties:
+          Name: my-target-group
+          Protocol: HTTP
+          ProtocolVersion: HTTP2
+          Port: 80
+          TargetType: ip
+          VpcId: !Ref myVPC
+          TargetGroupAttributes:
+            - Key: "routing.http2.rst_stream_error_forwarding.enabled"
+              Value: "true"
+