适用于 JavaScript 的 Amazon SDKV3 API 参考指南详细描述了 适用于 JavaScript 的 Amazon SDK 版本 3 (V3) 的所有 API 操作。
设置适用于 JavaScript 的 SDK
本节中的主题说明如何安装和加载 SDK for JavaScript,以便您可以访问该 SDK 支持的 Web 服务。
先决条件
安装 Node.js
设置 Amazon Node.js 环境
要设置可在其中运行应用程序的 Amazon Node.js 环境,请使用以下任意方法:
选择已预安装 Node.js 的 Amazon 机器映像 (AMI)。然后使用该 AMI 创建 Amazon EC2 实例。创建 Amazon EC2 实例时,从 Amazon Web Services Marketplace 中选择您的 AMI。在 Amazon Web Services Marketplace 中搜索 Node.js,然后选择包含 Node.js(32 位或 64 位)预安装版本的 AMI 选项。
创建 Amazon EC2 实例并在该实例上安装 Node.js。有关如何在 Amazon Linux 实例上安装 Node.js 的更多信息,请参阅在 Amazon EC2 实例上设置 Node.js。
使用 Amazon Lambda 创建无服务器环境,将 Node.js 作为 Lambda 函数运行。有关在 Lambda 函数中使用 Node.js 的更多信息,请参阅《Amazon Lambda 开发人员指南》 中的编程模型 (Node.js)。
将 Node.js 应用程序部署到 Amazon Elastic Beanstalk。有关将 Node.js 与 Elastic Beanstalk 结合使用的更多信息,请参阅《Amazon Elastic Beanstalk 开发人员指南》 中的将 Node.js 应用程序部署到 Amazon Elastic Beanstalk。
使用 Amazon OpsWorks 创建 Node.js 应用程序服务器。有关将 Node.js 与 Amazon OpsWorks 结合使用的更多信息,请参阅《Amazon OpsWorks 用户指南》中的创建您的第一个 Node.js 堆栈。
支持的 Web 浏览器
适用于 JavaScript 的 Amazon SDK 支持所有新式 Web 浏览器。
在版本 3.567.0 或更高版本中,适用于 JavaScript 的 SDK 生成 ES2021 构件,它支持以下最低版本。
| 浏览器 | 版本 |
|---|---|
| Google Chrome | 85.0+ |
| Mozilla Firefox | 80.0+ |
| Opera | 71.0+ |
| Microsoft Edge | 85.0+ |
| Apple Safari | 14.1+ |
| Samsung Internet | 14.0+ |
在版本 3.183.0 到 3.566.0 中,适用于 JavaScript 的 SDK 使用 ES2020 构件,它支持以下最低版本。
| 浏览器 | 版本 |
|---|---|
| Google Chrome | 80.0+ |
| Mozilla Firefox | 80.0+ |
| Opera | 63.0+ |
| Microsoft Edge | 80.0+ |
| Apple Safari | 14.1+ |
| Samsung Internet | 12.0+ |
在版本 3.183.0 或更早版本中,SDK for JavaScript 使用 ES5 构件,它支持以下最低版本。
| 浏览器 | 版本 |
|---|---|
| Google Chrome | 49.0+ |
| Mozilla Firefox | 45.0+ |
| Opera | 36.0+ |
| Microsoft Edge | 12.0+ |
| Windows Internet Explorer | 不适用 |
| Apple Safari | 9.0+ |
| Android 浏览器 | 76.0+ |
| UC 浏览器 | 12.12+ |
| Samsung Internet | 5.0+ |
注意
Amazon Amplify 等框架可能无法提供与 SDK for JavaScript 相同的浏览器支持。有关详细信息,请参阅 Amazon Amplify 文档。
安装 SDK for JavaScript
该 SDK 中的服务并不是全部直接可用或在所有 Amazon 区域可用的。
要使用 npm(Node.js 程序包管理器)SERVICE 是服务的名称,例如 s3。
npm install @aws-sdk/client-SERVICE
有关 适用于 JavaScript 的 Amazon SDK 服务客户端程序包的完整列表,请参阅 适用于 JavaScript 的 Amazon SDK API 参考指南。
加载 SDK for JavaScript
安装 SDK 之后,您可以使用 import,将客户端程序包加载到节点应用程序中。例如,要加载 Amazon S3 客户端和 Amazon S3 ListBuckets 命令,请使用以下代码。
import { S3Client, ListBucketsCommand } from "@aws-sdk/client-s3";