SuperAPI AI 工具集

aws-sdk-js-v3-usage

编程与开发

查看项目

更新于 10-15 17:22

技能介绍

用途:为使用 @aws-sdk/* 包(aws-sdk-js-v3)编写 JavaScript 或 TypeScript 代码、调用 AWS 服务的开发场景提供开发模式参考。启用该技能时不要在代码、注释或输出中使用 emoji。

包结构:@aws-sdk/client-* 按服务生成,与服务操作一一对应;@aws-sdk/lib-* 为更高层辅助(如 lib-dynamodb、lib-storage);无前缀的 @aws-sdk/* 多为内部工具包,不要深层导入,应始终从包根导入,如 import { S3Client } from "@aws-sdk/client-s3"。

客户端风格:推荐精简风格(体积更小),使用 new S3Client 与 client.send(new GetObjectCommand(...));聚合风格(如 new S3、client.getObject)体积更大。v3 无全局配置,region 必填,可显式传入或经 AWS_REGION 环境变量设置;实例化后不要读取或改写 client.config。

凭证:来自 @aws-sdk/credential-providers,按客户端惰性加载并缓存至到期前约 5 分钟。可用默认链 fromNodeProviderChain、AssumeRole 的 fromTemporaryCredentials、命名 profile;多区域客户端可共享 credentials 与 requestHandler。

流处理:必须读取或丢弃流式响应,否则会占用套接字;可用 Body.transformToString()、Body.transformToByteArray() 或 destroy/cancel,流只能读一次。分页用 paginate* 函数。DynamoDB 用 lib-dynamodb 的 DynamoDBDocumentClient 处理原生 JS 类型。S3 支持预签名 URL、lib-storage 的 Upload 分段上传与 waiters。错误处理检查 e.$metadata、e.name 或 instanceof。性能上按并行批量设置 maxSockets,注意流式死锁。中间件按 initialize→serialize→build→finalizeRequest→deserialize 顺序执行。可用 AbortController 取消请求。Lambda 中客户端应在处理函数外初始化,一次性异步初始化用惰性标志。版本要求:v3.968.0+ 需 Node.js >= 20,v3.723.0+ 需 Node.js >= 18。TypeScript 响应字段默认 T | undefined,可用 AssertiveClient、NodeJsClient、BrowserClient 收窄。S3 MRAP 等需 SigV4a,须安装并副作用导入 @aws-sdk/signature-v4-crt 或 @aws-sdk/signature-v4a 之一。

限制与缺失事实:具体收费、价格、平台支持范围、实际效果与逐步操作步骤暂未提供;更多细节见各 references 文档。