feat(client-elastic-load-balancing-v2): QUIC and TCP_QUIC protocol support for Network Load Balancer (NLB). This capability enables customers to forward QUIC traffic to their targets with ultra-low latency while maintaining session stickiness using QUIC Connection IDs.

awstools · awstools · commit 555b55decd1f · 2025-11-13T19:15:49.000Z
diff --git a/clients/client-elastic-load-balancing-v2/src/commands/CreateListenerCommand.ts b/clients/client-elastic-load-balancing-v2/src/commands/CreateListenerCommand.ts
@@ -66,7 +66,7 @@ export interface CreateListenerCommandOutput extends CreateListenerOutput, __Met
  * const client = new ElasticLoadBalancingV2Client(config);
  * const input = { // CreateListenerInput
  *   LoadBalancerArn: "STRING_VALUE", // required
- *   Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE",
+ *   Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE" || "QUIC" || "TCP_QUIC",
  *   Port: Number("int"),
  *   SslPolicy: "STRING_VALUE",
  *   Certificates: [ // CertificateList
@@ -173,7 +173,7 @@ export interface CreateListenerCommandOutput extends CreateListenerOutput, __Met
  * //       ListenerArn: "STRING_VALUE",
  * //       LoadBalancerArn: "STRING_VALUE",
  * //       Port: Number("int"),
- * //       Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE",
+ * //       Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE" || "QUIC" || "TCP_QUIC",
  * //       Certificates: [ // CertificateList
  * //         { // Certificate
  * //           CertificateArn: "STRING_VALUE",
diff --git a/clients/client-elastic-load-balancing-v2/src/commands/CreateTargetGroupCommand.ts b/clients/client-elastic-load-balancing-v2/src/commands/CreateTargetGroupCommand.ts
@@ -65,11 +65,11 @@ export interface CreateTargetGroupCommandOutput extends CreateTargetGroupOutput,
  * const client = new ElasticLoadBalancingV2Client(config);
  * const input = { // CreateTargetGroupInput
  *   Name: "STRING_VALUE", // required
- *   Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE",
+ *   Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE" || "QUIC" || "TCP_QUIC",
  *   ProtocolVersion: "STRING_VALUE",
  *   Port: Number("int"),
  *   VpcId: "STRING_VALUE",
- *   HealthCheckProtocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE",
+ *   HealthCheckProtocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE" || "QUIC" || "TCP_QUIC",
  *   HealthCheckPort: "STRING_VALUE",
  *   HealthCheckEnabled: true || false,
  *   HealthCheckPath: "STRING_VALUE",
@@ -97,10 +97,10 @@ export interface CreateTargetGroupCommandOutput extends CreateTargetGroupOutput,
  * //     { // TargetGroup
  * //       TargetGroupArn: "STRING_VALUE",
  * //       TargetGroupName: "STRING_VALUE",
- * //       Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE",
+ * //       Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE" || "QUIC" || "TCP_QUIC",
  * //       Port: Number("int"),
  * //       VpcId: "STRING_VALUE",
- * //       HealthCheckProtocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE",
+ * //       HealthCheckProtocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE" || "QUIC" || "TCP_QUIC",
  * //       HealthCheckPort: "STRING_VALUE",
  * //       HealthCheckEnabled: true || false,
  * //       HealthCheckIntervalSeconds: Number("int"),
diff --git a/clients/client-elastic-load-balancing-v2/src/commands/DeregisterTargetsCommand.ts b/clients/client-elastic-load-balancing-v2/src/commands/DeregisterTargetsCommand.ts
@@ -73,6 +73,7 @@ export interface DeregisterTargetsCommandOutput extends DeregisterTargetsOutput,
  *       Id: "STRING_VALUE", // required
  *       Port: Number("int"),
  *       AvailabilityZone: "STRING_VALUE",
+ *       QuicServerId: "STRING_VALUE",
  *     },
  *   ],
  * };
diff --git a/clients/client-elastic-load-balancing-v2/src/commands/DescribeListenersCommand.ts b/clients/client-elastic-load-balancing-v2/src/commands/DescribeListenersCommand.ts
@@ -58,7 +58,7 @@ export interface DescribeListenersCommandOutput extends DescribeListenersOutput,
  * //       ListenerArn: "STRING_VALUE",
  * //       LoadBalancerArn: "STRING_VALUE",
  * //       Port: Number("int"),
- * //       Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE",
+ * //       Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE" || "QUIC" || "TCP_QUIC",
  * //       Certificates: [ // CertificateList
  * //         { // Certificate
  * //           CertificateArn: "STRING_VALUE",
diff --git a/clients/client-elastic-load-balancing-v2/src/commands/DescribeTargetGroupsCommand.ts b/clients/client-elastic-load-balancing-v2/src/commands/DescribeTargetGroupsCommand.ts
@@ -61,10 +61,10 @@ export interface DescribeTargetGroupsCommandOutput extends DescribeTargetGroupsO
  * //     { // TargetGroup
  * //       TargetGroupArn: "STRING_VALUE",
  * //       TargetGroupName: "STRING_VALUE",
- * //       Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE",
+ * //       Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE" || "QUIC" || "TCP_QUIC",
  * //       Port: Number("int"),
  * //       VpcId: "STRING_VALUE",
- * //       HealthCheckProtocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE",
+ * //       HealthCheckProtocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE" || "QUIC" || "TCP_QUIC",
  * //       HealthCheckPort: "STRING_VALUE",
  * //       HealthCheckEnabled: true || false,
  * //       HealthCheckIntervalSeconds: Number("int"),
diff --git a/clients/client-elastic-load-balancing-v2/src/commands/DescribeTargetHealthCommand.ts b/clients/client-elastic-load-balancing-v2/src/commands/DescribeTargetHealthCommand.ts
@@ -47,6 +47,7 @@ export interface DescribeTargetHealthCommandOutput extends DescribeTargetHealthO
  *       Id: "STRING_VALUE", // required
  *       Port: Number("int"),
  *       AvailabilityZone: "STRING_VALUE",
+ *       QuicServerId: "STRING_VALUE",
  *     },
  *   ],
  *   Include: [ // ListOfDescribeTargetHealthIncludeOptions
@@ -62,6 +63,7 @@ export interface DescribeTargetHealthCommandOutput extends DescribeTargetHealthO
  * //         Id: "STRING_VALUE", // required
  * //         Port: Number("int"),
  * //         AvailabilityZone: "STRING_VALUE",
+ * //         QuicServerId: "STRING_VALUE",
  * //       },
  * //       HealthCheckPort: "STRING_VALUE",
  * //       TargetHealth: { // TargetHealth
diff --git a/clients/client-elastic-load-balancing-v2/src/commands/ModifyListenerCommand.ts b/clients/client-elastic-load-balancing-v2/src/commands/ModifyListenerCommand.ts
@@ -50,7 +50,7 @@ export interface ModifyListenerCommandOutput extends ModifyListenerOutput, __Met
  * const input = { // ModifyListenerInput
  *   ListenerArn: "STRING_VALUE", // required
  *   Port: Number("int"),
- *   Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE",
+ *   Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE" || "QUIC" || "TCP_QUIC",
  *   SslPolicy: "STRING_VALUE",
  *   Certificates: [ // CertificateList
  *     { // Certificate
@@ -150,7 +150,7 @@ export interface ModifyListenerCommandOutput extends ModifyListenerOutput, __Met
  * //       ListenerArn: "STRING_VALUE",
  * //       LoadBalancerArn: "STRING_VALUE",
  * //       Port: Number("int"),
- * //       Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE",
+ * //       Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE" || "QUIC" || "TCP_QUIC",
  * //       Certificates: [ // CertificateList
  * //         { // Certificate
  * //           CertificateArn: "STRING_VALUE",
diff --git a/clients/client-elastic-load-balancing-v2/src/commands/ModifyTargetGroupCommand.ts b/clients/client-elastic-load-balancing-v2/src/commands/ModifyTargetGroupCommand.ts
@@ -43,7 +43,7 @@ export interface ModifyTargetGroupCommandOutput extends ModifyTargetGroupOutput,
  * const client = new ElasticLoadBalancingV2Client(config);
  * const input = { // ModifyTargetGroupInput
  *   TargetGroupArn: "STRING_VALUE", // required
- *   HealthCheckProtocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE",
+ *   HealthCheckProtocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE" || "QUIC" || "TCP_QUIC",
  *   HealthCheckPort: "STRING_VALUE",
  *   HealthCheckPath: "STRING_VALUE",
  *   HealthCheckEnabled: true || false,
@@ -63,10 +63,10 @@ export interface ModifyTargetGroupCommandOutput extends ModifyTargetGroupOutput,
  * //     { // TargetGroup
  * //       TargetGroupArn: "STRING_VALUE",
  * //       TargetGroupName: "STRING_VALUE",
- * //       Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE",
+ * //       Protocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE" || "QUIC" || "TCP_QUIC",
  * //       Port: Number("int"),
  * //       VpcId: "STRING_VALUE",
- * //       HealthCheckProtocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE",
+ * //       HealthCheckProtocol: "HTTP" || "HTTPS" || "TCP" || "TLS" || "UDP" || "TCP_UDP" || "GENEVE" || "QUIC" || "TCP_QUIC",
  * //       HealthCheckPort: "STRING_VALUE",
  * //       HealthCheckEnabled: true || false,
  * //       HealthCheckIntervalSeconds: Number("int"),
diff --git a/clients/client-elastic-load-balancing-v2/src/commands/RegisterTargetsCommand.ts b/clients/client-elastic-load-balancing-v2/src/commands/RegisterTargetsCommand.ts
@@ -74,6 +74,7 @@ export interface RegisterTargetsCommandOutput extends RegisterTargetsOutput, __M
  *       Id: "STRING_VALUE", // required
  *       Port: Number("int"),
  *       AvailabilityZone: "STRING_VALUE",
+ *       QuicServerId: "STRING_VALUE",
  *     },
  *   ],
  * };
diff --git a/clients/client-elastic-load-balancing-v2/src/models/models_0.ts b/clients/client-elastic-load-balancing-v2/src/models/models_0.ts
@@ -1465,7 +1465,9 @@ export const ProtocolEnum = {
   GENEVE: "GENEVE",
   HTTP: "HTTP",
   HTTPS: "HTTPS",
+  QUIC: "QUIC",
   TCP: "TCP",
+  TCP_QUIC: "TCP_QUIC",
   TCP_UDP: "TCP_UDP",
   TLS: "TLS",
   UDP: "UDP",
@@ -3841,6 +3843,17 @@ export interface TargetDescription {
    * @public
    */
   AvailabilityZone?: string | undefined;
+
+  /**
+   * <p>The server ID for the targets. This value is required if the protocol is
+   *       <code>QUIC</code> or <code>TCP_QUIC</code> and can't be used with other protocols.</p>
+   *          <p>The ID consists of the <code>0x</code> prefix followed by 16 hexadecimal characters.
+   *       Any letters must be lowercase. The value must be unique at the listener level. You can't
+   *       modify the server ID for a registered target. You must deregister the target and then
+   *       provide a new server ID when you register the target again.</p>
+   * @public
+   */
+  QuicServerId?: string | undefined;
 }
 
 /**
diff --git a/clients/client-elastic-load-balancing-v2/src/schemas/schemas_0.ts b/clients/client-elastic-load-balancing-v2/src/schemas/schemas_0.ts
@@ -297,6 +297,7 @@ const _Pr = "Protocol";
 const _Q = "Query";
 const _QSC = "QueryStringConfig";
 const _QSCC = "QueryStringConditionConfig";
+const _QSI = "QuicServerId";
 const _QSKVP = "QueryStringKeyValuePair";
 const _QSKVPL = "QueryStringKeyValuePairList";
 const _R = "Reason";
@@ -1621,7 +1622,7 @@ TypeRegistry.for(n0).registerError(SubnetNotFoundException, __SubnetNotFoundExce
 
 export var Tag: StaticStructureSchema = [3, n0, _Tag, 0, [_K, _Va], [0, 0]];
 export var TagDescription: StaticStructureSchema = [3, n0, _TDa, 0, [_RAe, _Ta], [0, () => TagList]];
-export var TargetDescription: StaticStructureSchema = [3, n0, _TDar, 0, [_Id, _Po, _AZ], [0, 1, 0]];
+export var TargetDescription: StaticStructureSchema = [3, n0, _TDar, 0, [_Id, _Po, _AZ, _QSI], [0, 1, 0, 0]];
 export var TargetGroup: StaticStructureSchema = [
   3,
   n0,
diff --git a/codegen/sdk-codegen/aws-models/elastic-load-balancing-v2.json b/codegen/sdk-codegen/aws-models/elastic-load-balancing-v2.json
@@ -7767,6 +7767,18 @@
           "traits": {
             "smithy.api#enumValue": "GENEVE"
           }
+        },
+        "QUIC": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "QUIC"
+          }
+        },
+        "TCP_QUIC": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "TCP_QUIC"
+          }
         }
       }
     },
@@ -7813,6 +7825,15 @@
         "target": "com.amazonaws.elasticloadbalancingv2#QueryStringKeyValuePair"
       }
     },
+    "com.amazonaws.elasticloadbalancingv2#QuicServerId": {
+      "type": "string",
+      "traits": {
+        "smithy.api#length": {
+          "min": 1,
+          "max": 256
+        }
+      }
+    },
     "com.amazonaws.elasticloadbalancingv2#RedirectActionConfig": {
       "type": "structure",
       "members": {
@@ -9297,6 +9318,12 @@
           "traits": {
             "smithy.api#documentation": "<p>An Availability Zone or <code>all</code>. This determines whether the target receives \n      traffic from the load balancer nodes in the specified Availability Zone or from all enabled \n      Availability Zones for the load balancer.</p>\n         <p>For Application Load Balancer target groups, the specified Availability Zone value is only applicable \n      when cross-zone load balancing is off. Otherwise the parameter is ignored and treated \n      as <code>all</code>.</p>\n         <p>This parameter is not supported if the target type of the target group is\n      <code>instance</code> or <code>alb</code>.</p>\n         <p>If the target type is <code>ip</code> and the IP address is in a subnet of the VPC for the target group, \n      the Availability Zone is automatically detected and this parameter is optional. If the IP address is outside \n      the VPC, this parameter is required.</p>\n         <p>For Application Load Balancer target groups with cross-zone load balancing off, if the target type \n      is <code>ip</code> and the IP address is outside of the VPC for the target group, this should be an \n      Availability Zone inside the VPC for the target group.</p>\n         <p>If the target type is <code>lambda</code>, this parameter is optional and the only\n      supported value is <code>all</code>.</p>"
           }
+        },
+        "QuicServerId": {
+          "target": "com.amazonaws.elasticloadbalancingv2#QuicServerId",
+          "traits": {
+            "smithy.api#documentation": "<p>The server ID for the targets. This value is required if the protocol is \n      <code>QUIC</code> or <code>TCP_QUIC</code> and can't be used with other protocols.</p>\n         <p>The ID consists of the <code>0x</code> prefix followed by 16 hexadecimal characters. \n      Any letters must be lowercase. The value must be unique at the listener level. You can't \n      modify the server ID for a registered target. You must deregister the target and then \n      provide a new server ID when you register the target again.</p>"
+          }
         }
       },
       "traits": {
