适用于 JavaScript 的 Amazon SDKV3 API 参考指南详细描述了 适用于 JavaScript 的 Amazon SDK 版本 3 (V3) 的所有 API 操作。
适用于 JavaScript 的 Amazon SDK 是什么?
欢迎阅读《适用于 JavaScript 的 Amazon SDK 开发人员指南》。本指南提供有关设置和配置 适用于 JavaScript 的 Amazon SDK 的一般信息。它还会引导您完成使用 适用于 JavaScript 的 Amazon SDK 运行各种 Amazon 服务的示例和教程。
适用于 JavaScript 的 Amazon SDK v3 API 参考指南为 Amazon 服务提供了 JavaScript API。您可以使用 JavaScript API 构建适用于 Node.js
开始使用 SDK
如果您已准备好亲身体验 SDK,请遵循开始使用 适用于 JavaScript 的 Amazon SDK 中的示例。
要设置开发环境,请参阅设置适用于 JavaScript 的 SDK。
如果您当前使用的是适用于 JavaScript 的 SDK 2.x 版,请参阅迁移到 3.x 版,获取具体指导。
如需查找 Amazon Web Services 服务的代码示例,请参阅SDK for JavaScript (v3) 代码示例。
SDK 主要版本的维护和支持
有关维护和支持 SDK 主要版本及其基础依赖关系的信息,请参阅 Amazon SDK 和工具参考指南中的以下内容:
将 SDK 与 Node.js 配合使用
Node.js 是一个用于运行服务器端 JavaScript 应用程序的跨平台运行时系统。您可以在 Amazon Elastic Compute Cloud (Amazon EC2) 实例上设置 Node.js 以在服务器上运行。您还可以使用 Node.js 来编写按需 Amazon Lambda 函数。
使用 SDK for Node.js 与在 Web 浏览器中将其用于 JavaScript 的方式不同。区别在于,您加载 SDK 以及获取访问特定 Web 服务所需凭证的方法有所不同。如果在 Node.js 与浏览器之间使用特定 API 存在差别时,我们将对这些差别进行说明。
将 SDK 与 Amazon Amplify 结合使用
对于基于浏览器的 Web、移动和混合应用程序,您也可以使用 GitHub 上的 Amazon Amplify 库
注意
Amplify 等框架可能无法提供与 SDK for JavaScript 相同的浏览器支持。有关详细信息,请查看框架文档。
将 SDK 与 Web 浏览器结合使用
所有主流 Web 浏览器支持 JavaScript 的执行。在 Web 浏览器中运行的 JavaScript 代码通常称为客户端 JavaScript。
有关 适用于 JavaScript 的 Amazon SDK 支持的浏览器列表,请参阅支持的 Web 浏览器。
在 Web 浏览器中使用 SDK for JavaScript 与在 Node.js 中使用它的方式不同。区别在于,您加载 SDK 以及获取访问特定 Web 服务所需凭证的方法有所不同。如果在 Node.js 与浏览器之间使用特定 API 存在差别时,我们将对这些差别进行说明。
在 V3 中使用浏览器
V3 允许您仅将所需的 SDK for JavaScript 文件捆绑和包含在浏览器中,从而减少开销。
要在 HTML 页面中使用 SDK for JavaScript V3,必须使用 Webpack 将所需的客户端模块和所有必需的 JavaScript 函数捆绑到一个 JavaScript 文件中,然后将其添加到 HTML 页面 <head> 的脚本标签中。例如:
<script src="./main.js"></script>
注意
有关 Webpack 的更多信息,请参阅使用 Webpack 捆绑应用程序。
要使用 SDK for JavaScript V2,您需要添加一个指向 V2 SDK 最新版本的脚本标签。有关更多信息,请参阅《适用于 JavaScript 的 Amazon SDK 开发人员指南 v2》中的示例。
常见使用案例
在浏览器脚本中使用 SDK for JavaScript 实现了多种颇具吸引力的使用案例。通过使用 SDK for JavaScript 访问各种 Web 服务,您可以在浏览器应用程序中构建一些东西,此处介绍了几个相关想法。
-
构建 Amazon 服务的自定义控制台,在其中您可以跨区域和服务访问并组合功能,从而最好地满足您的组织或项目需求。
-
使用 Amazon Cognito 以启用对您的浏览器应用程序和网站的经身份验证用户的访问,包括使用来自 Facebook 和其他提供商的第三方身份验证。
-
使用 Amazon Kinesis 实时处理点击流或其他营销数据。
-
为无服务器数据持久性使用 Amazon DynamoDB,例如针对网站访问者或应用程序用户的单独用户首选项。
-
使用 Amazon Lambda 封装专有逻辑,您可以从浏览器脚本调用逻辑而无需下载和向用户泄露您的知识产权。
关于示例
您可以在 Amazon 代码示例存储库
资源
除了本指南外,还有以下适用于 SDK for JavaScript 开发人员的在线资源:
-
Amazon SDK 和工具参考指南:包含 Amazon SDK 中常见的设置、功能和其他基础概念。
-
GitHub