迁移到版本 3 - Amazon SDK for JavaScript
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

Amazon SDK for JavaScript V3 API 参考指南详细描述了 Amazon SDK for JavaScript 版本 3 (V3) 的所有 API 操作。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

迁移到版本 3

本节介绍如何从的版本 2 迁移到版本 3 Amazon SDK for JavaScript。

将您的代码迁移到 JavaScript V3 版 SDK

Amazon SDK for JavaScript 版本 3 (v3) 带有用于客户端配置和实用程序的现代化界面,包括凭证、Amazon S3 分段上传、DynamoDB 文档客户端、服务员等。您可以在 repo 的迁移指南中找到 v2 中更改的内容以及每项更改的 v3 等效内容。 Amazon SDK for JavaScript GitHub

要充分利用 Amazon SDK for JavaScript v3,我们建议使用下面描述的 codemod 脚本。

使用 codemod 迁移现有的 v2 代码

中的 codemod 脚本集aws-sdk-js-codemod有助于将现有的 Amazon SDK for JavaScript (v2) 应用程序迁移到使用 v3 API。您可以按以下方式运行转换。

$ npx aws-sdk-js-codemod -t v2-to-v3 PATH...

例如,假设您有以下代码,它用于从 v2 创建一个 Amazon DynamoDB 客户端并调用 listTables 运算。

// example.ts import AWS from "aws-sdk"; const region = "us-west-2"; const client = new AWS.DynamoDB({ region }); client.listTables({}, (err, data) => { if (err) console.log(err, err.stack); else console.log(data); });

你可以按如下方式对 example.ts 运行我们的 v2-to-v3 转换。

$ npx aws-sdk-js-codemod -t v2-to-v3 example.ts

转换会将 DynamoDB 导入转换为 v3,创建 v3 客户端,然后调用 listTables 运算,如下所示。

// example.ts import { DynamoDB } from "@aws-sdk/client-dynamodb"; const region = "us-west-2"; const client = new DynamoDB({ region }); client.listTables({}, (err, data) => { if (err) console.log(err, err.stack); else console.log(data); });

我们已经针对常见使用案例实现了转换。如果您的代码无法正确转换,请使用示例输入代码和观察到/预期的输出代码创建错误报告功能请求。如果某个现有问题已经报告了您的特定使用案例,请通过投赞同票表示支持。