TheAWS SDK for JavaScript V3 API Reference Guide describes in detail all the API operations for the AWS SDK for JavaScript version 3 (V3).
Reuse connections with keep-alive in Node.js
The default Node.js HTTP/HTTPS agent creates a new TCP connection for every new request. To avoid the cost of establishing a new connection, the AWS SDK for JavaScript reuses TCP connectionsby default.
For short-lived operations, such as Amazon DynamoDB queries, the latency overhead of setting up a TCP connection might be greater than the operation itself. Additionally, since DynamoDBencryption at rest is integrated withAWS KMS, you may experience latencies from the database having to re-establish new AWS KMS cache entries for each operation.
If you do not want to reuse TCP connections, you can disable reusing these connections alive withkeepAlive on a per-service client basis as shown in the following example for a DynamoDB client.
import{ DynamoDBClient } from "@aws-sdk/client-dynamodb";import{ NodeHttpHandler } from "@smithy/node-http-handler";import{ Agent } from "https";const dynamodbClient = new DynamoDBClient({ requestHandler: new NodeHttpHandler({ httpsAgent: new Agent({ keepAlive: false }) })});IfkeepAlive is enabled, you can also set the initial delay for TCP Keep-Alive packets withkeepAliveMsecs, which by default is 1000 ms. See theNode.js documentation for details.
