帮助我们改进AWS SDK for JavaScript版本 3 (V3) 文档,方法是使用反馈链接,或者在上创建议题或拉取请求GitHub
这些区域有:AWS SDK for JavaScriptV3 API 参考指南详细描述了所有的 API 操作AWS SDK for JavaScript版本 3 (V3)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用 Amazon S3 存储桶作为静态 Web 主机
此 Node.js 代码示例演示:
-
如何设置 Amazon S3 存储桶作为静态 Web 主机。
场景
在此示例中,使用一系列 Node.js 模块将您的任意存储桶配置作为静态 Web 主机。Node.js 模块使用 SDK JavaScript 使用 Amazon S3 客户端类的以下方法来配置选定 Amazon S3 存储桶:
有关将 Amazon S3 存储桶用作静态 Web 主机的更多信息,请参阅。在 Amazon S3 上托管静态网站中的Amazon Simple Storage Service 用户指南.
先决条件任
要设置和运行此示例,您必须先完成以下任务:
-
设置项目环境以运行 Node JavaScript 按照上的说明操作示例GitHub
. -
使用用户凭证创建共享配置文件。有关提供共享凭证文件的更多信息,请参阅从共享凭证文件加载 Node.js 中的凭证。
这些示例演示了如何使用 ECMASCRIPT6 (ES6) 导入/导出客户端服务对象和命令。
这需要 Node.js 版本 13.x 或更高版本。要下载并安装最新版本的 Node.js,请参阅Node.js 下载。
. 如果您希望使用 Simple Js 语法,请参阅JavaScript ES6/常用JS 语法.
检索当前存储桶网站配置
创建libs
创建文件名为的 Node.js 模块s3Client.js
. 将以下代码复制并粘贴到其中,这将创建 Amazon S3 客户端对象。Replace领域
使用您的AWSregion 区域。
// Create service client module using ES6 syntax. import { S3Client } from "@aws-sdk/client-s3"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create an Amazon S3 service client object. const s3Client = new S3Client({ region: REGION }); export { s3Client };
这个代码是可用的GitHub 上的
创建文件名为 s3_getbucketwebsite.js
的 Node.js 模块。该模块将获取单个命令行参数,指定需要其网站配置的存储桶。如前所示配置 SDK,包括安装所需的客户端和软件包。
创建一个函数,检索在存储桶列表中选择的存储桶的当前存储桶网站配置。在调用 GetBucketWebsiteCommand
方法时,您需要传递的唯一参数是所选存储桶的名称。如果存储桶当前具有网站配置,该配置将由 Amazon S3 在data
参数传递给回调函数。
如果所选存储桶没有网站配置,该信息将在 err
参数中返回给回调函数。
// Import required AWS SDK clients and commands for Node.js. import { GetBucketWebsiteCommand } from "@aws-sdk/client-s3"; import { s3Client } from "./libs/s3Client.js"; // Helper function that creates an Amazon S3 service client module. // Create the parameters for calling export const bucketParams = { Bucket: "BUCKET_NAME" }; export const run = async () => { try { const data = await s3Client.send(new GetBucketWebsiteCommand(bucketParams)); console.log("Success", data); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run();
要运行示例,请在命令提示符处输入以下内容。
node s3_getbucketwebsite.js
此示例代码可在 GitHub 上的此处
设置存储桶网站配置
创建libs
创建文件名为的 Node.js 模块s3Client.js
. 将以下代码复制并粘贴到其中,这将创建 Amazon S3 客户端对象。Replace领域
使用您的AWSregion 区域。
// Create service client module using ES6 syntax. import { S3Client } from "@aws-sdk/client-s3"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create an Amazon S3 service client object. const s3Client = new S3Client({ region: REGION }); export { s3Client };
这个代码是可用的GitHub 上的
创建文件名为 s3_setbucketwebsite.js
的 Node.js 模块。确保按前面所示配置开发工具包,包括安装所需的客户端和软件包。创建S3
客户端服务对象。
创建应用存储桶网站配置的函数。该配置允许将所选存储桶用作静态 Web 主机。网站配置以 JSON 形式指定。首先,创建包含用于指定网站配置的所有值的 JSON 对象,但标识错误文档的 Key
值以及标识索引文档的 Suffix
值除外。
将文本输入元素的值插入到 JSON 对象中。准备 PutBucketWebsiteCommand
方法的参数,包括存储桶的名称以及 JSON 网站配置。
// Import required AWS SDK clients and commands for Node.js. import { PutBucketWebsiteCommand } from "@aws-sdk/client-s3"; import { s3Client } from "./libs/s3Client.js"; // Helper function that creates an Amazon S3 service client module. // Create the parameters for the bucket export const bucketParams = { Bucket: "BUCKET_NAME" }; export const staticHostParams = { Bucket: bucketParams, WebsiteConfiguration: { ErrorDocument: { Key: "", }, IndexDocument: { Suffix: "", }, }, }; export const run = async () => { // Insert specified bucket name and index and error documents into parameters JSON // from command line arguments staticHostParams.Bucket = bucketParams; staticHostParams.WebsiteConfiguration.IndexDocument.Suffix = "INDEX_PAGE"; // The index document inserted into parameters JSON. staticHostParams.WebsiteConfiguration.ErrorDocument.Key = "ERROR_PAGE"; // The error document inserted into parameters JSON. // Set the new website configuration on the selected bucket. try { const data = await s3Client.send(new PutBucketWebsiteCommand(staticHostParams)); console.log("Success", data); } catch (err) { console.log("Error", err); } }; run();
要运行示例,请在命令提示符处输入以下内容。
node s3_setbucketwebsite.js
此示例代码可在 GitHub 上的此处
删除存储桶网站配置
创建libs
创建文件名为的 Node.js 模块s3Client.js
. 将以下代码复制并粘贴到其中,这将创建 Amazon S3 客户端对象。Replace领域
使用您的AWSregion 区域。
// Create service client module using ES6 syntax. import { S3Client } from "@aws-sdk/client-s3"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create an Amazon S3 service client object. const s3Client = new S3Client({ region: REGION }); export { s3Client };
这个代码是可用的GitHub 上的
创建文件名为 s3_deletebucketwebsite.js
的 Node.js 模块。确保按前面所示配置开发工具包,包括安装所需的客户端和软件包。创建S3
客户端服务对象。
创建删除所选存储桶的网站配置的函数。在调用 DeleteBucketWebsiteCommand
方法时,您需要传递的唯一参数是所选存储桶的名称。
// Import required AWS SDK clients and commands for Node.js. import { DeleteBucketWebsiteCommand } from "@aws-sdk/client-s3"; import { s3Client } from "./libs/s3Client.js"; // Helper function that creates an Amazon S3 service client module. // Create the parameters for calling export const bucketParams = { Bucket: "BUCKET_NAME" }; export const run = async () => { try { const data = await s3Client.send(new DeleteBucketWebsiteCommand(bucketParams)); return data; // For unit tests. console.log("Success", data); } catch (err) { console.log("Error", err); } }; run();
要运行示例,请在命令提示符处输入以下内容。
node s3_deletebucketwebsite.js
此示例代码可在 GitHub 上的此处