使用 Amazon S3 对象 - AWS 适用于 VS Code 的工具包
对象分页将文件上传到 S3 存储桶编辑远程对象复制路径生成预签名 URL删除 S3 对象

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

使用 Amazon S3 对象

您存储在 Amazon S3 资源存储桶中的文件、文件夹以及任何其他数据都称为 Amazon S3 对象。

以下各节介绍了如何通过 AWS Toolkit for Visual Studio Code 使用 Amazon S3 对象。有关使用 Amazon S3 资源（例如 Amazon S3 存储桶）的详细信息，请参阅本用户指南中的使用 Amazon S3 资源主题。

对象分页

如果您正在使用大量 Amazon S3 对象和文件夹，分页允许您指定要在页面上显示的项目数量。

  1. 导航到 VS Code 活动栏并选择扩展。

  2. 从 AWS Toolkit 扩展中，选择“设置”图标，然后选择扩展设置。

  3. 在设置页面上，向下滚动至 AWS > Amazon S3：每页最大项目数设置。

  4. 在“加载更多”选项显示之前，将默认值更改为您要显示的 Amazon S3 项目数量。

    注意

    有效值包括 3 到 1000 之间的任意数字。此设置仅适用于同时显示的对象或文件夹的数量。您创建的所有存储桶都会一次性显示。默认情况下，您可以在每个AWS账户中创建多达 100 个存储桶。

  5. 关闭设置页面以确认您的更改。

您还可以通过选择设置页面右上角的打开设置（JSON）图标，更新 JSON 格式文件中的设置。

上传和下载 Amazon S3 对象

您可以通过 AWS Toolkit for Visual Studio Code 将本地存储的文件上传到您的 Amazon S3 存储桶，也可以将远程 Amazon S3 对象下载到您的本地系统中。

使用 Toolkit 上传文件

  1. 在 Toolkit 资源管理器中，展开 Amazon S3 服务以查看 Amazon S3 资源列表。

  2. 选择位于存储桶或文件夹旁边的“上传文件”图标，以打开“上传文件”对话框。或者，您也可以打开文件的上下文菜单（右键单击），然后选择上传文件。

    注意

    要将文件上传到对象的父文件夹或资源，请打开任意 Amazon S3 对象的上下文菜单（右键单击），然后选择上传至父级。

  3. 使用系统的文件管理器选择一个文件，然后选择上传文件以关闭对话框并上传文件。

使用“命令面板”上传文件

您可以使用 Toolkit 界面或命令面板将文件上传到存储桶。

  1. 要选择要上传的文件，请在 VS Code 中选择该文件的选项卡。

  2. 按下 Ctrl+Shift+P 以显示命令面板。

  3. 在命令面板中，输入短语 upload file 以显示推荐的命令列表。

  4. 选择 AWS：上传文件 命令以打开 AWS：上传文件 对话框。

  5. 出现提示时，选择要上传的文件，然后选择要将该文件上传到的存储桶。

  6. 确认您的上传，以关闭对话框并开始上传流程。上传完毕后，该对象将显示在 Toolkit 菜单中，并且包含对象大小、上次修改日期和路径等元数据。

下载 Amazon S3 对象

  1. 在 Toolkit 资源管理器中，展开 Amazon S3 服务。

  2. 在存储桶或文件夹中，打开要下载的对象的上下文菜单（右键单击）。然后，选择下载为以打开“下载为”对话框。或者，也可以选择对象旁边的下载为图标。

  3. 使用系统的文件管理器，选择目标文件夹，输入文件名，然后选择下载以关闭对话框并开始下载。

编辑远程对象

您可以使用 AWS Toolkit for Visual Studio Code 来编辑存储在远程 Amazon S3 资源中的 Amazon S3 对象。

  1. 在 Toolkit 资源管理器中，展开 Amazon S3 服务。

  2. 展开包含要编辑的文件的 Amazon S3 资源。

  3. 要编辑文件，请选择铅笔图标（“编辑文件”）。

  4. 要编辑以只读模式打开的文件，请在 VS Code 编辑器中查看该文件，然后选择位于 UI 右上角的铅笔图标。

注意

  • 如果您重新启动或退出 VS Code，则您的 IDE 将会与 Amazon S3 资源断开连接。如果您断开连接时正在编辑任何远程 Amazon S3 文件，则编辑操作将会停止。您必须重新启动 VS Code 并重新打开编辑选项卡才能恢复编辑。

  • 编辑文件按钮位于 UI 的右上角。只有当您在 VS Code 编辑器中主动查看只读文件时，它才可见。

  • 无法以只读模式打开非文本文件。它们始终以编辑模式打开。

  • 您无法从仅限编辑模式切换回只读模式，只能从只读模式切换回仅限编辑模式。

复制 Amazon S3 对象的路径

以下流程了如何从 AWS Toolkit for Visual Studio Code 复制 Amazon S3 对象的路径。

  1. 在 Toolkit 资源管理器中，展开 Amazon S3 服务。

  2. 展开包含要复制路径的对象的资源存储桶。

  3. 打开要复制路径的对象的上下文菜单（右键单击），然后选择复制路径，以将对象路径复制到本地剪贴板。

为 Amazon S3 对象生成预签名 URL

您可以通过预签名 URL 功能授予限时下载权限，从而与其他人共享私有 Amazon S3 对象。有关更多信息，请参阅使用预签名 URL 共享对象。

  1. 在 Toolkit 资源管理器中，展开 Amazon S3 服务。

  2. 在存储桶或文件夹中，打开要共享的对象的上下文菜单（右键单击）。然后，选择生成预签名 URL 以打开命令面板。

  3. 在命令面板中，输入可使用该 URL 访问对象的分钟数。然后，选择 Enter 键以确认并关闭对话框。

  4. 生成预签名 URL 后，VS Code 状态栏会显示已复制到本地剪贴板的对象的预签名 URL。

删除 Amazon S3 对象

如果对象位于不受版本控制的存储桶中，您可以永久删除它。对于启用版本控制的存储桶，删除请求不会永久删除该对象。但是，Amazon S3 将在存储桶中插入一个删除标记。有关更多信息，请参阅删除对象版本。

  1. 在 Toolkit 资源管理器中，展开 Amazon S3 服务以查看 Amazon S3 资源列表。

  2. 打开要删除的对象的上下文菜单（右键单击），然后选择删除以打开确认对话框。

  3. 选择删除…，以确认您想要删除这个 Amazon S3 对象。然后，关闭对话框。