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

# 使用 Amazon S3
<a name="s3"></a>

Amazon Simple Storage Service（Amazon S3）是一项可扩展的数据存储服务。AWS Toolkit for Visual Studio Code 允许您直接通过 VS Code 代码管理您的 Amazon S3 对象和资源。

有关 Amazon S3 服务的详细信息，请参阅 [Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/) 用户指南。

以下主题介绍了如何通过 AWS Toolkit for Visual Studio Code 使用 Amazon S3 对象和资源。

**Topics**
+ [使用 Amazon S3 资源](s3-service.md)
+ [使用 Amazon S3 对象](s3-service-objects.md)

# 使用 Amazon S3 资源
<a name="s3-service"></a>

您可以通过 AWS Toolkit for Visual Studio Code 使用 Amazon S3 来查看、管理和编辑您的 Amazon S3 存储桶和其他资源。

以下各节介绍了如何通过 AWS Toolkit for Visual Studio Code 使用 Amazon S3 资源。有关通过 AWS Toolkit for Visual Studio Code 使用 Amazon S3 对象（例如文件夹和文件）的信息，请参阅本用户指南中的[使用 Amazon S3 对象](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/s3-service-objects.html)主题。

## 创建 Amazon S3 存储桶
<a name="s3-service-resources-bucket"></a>

1. 在 Toolkit 资源管理器中，打开 **Amazon S3** 服务的上下文菜单（右键单击），然后选择**创建存储桶…**。或者，选择**创建存储桶**图标，以打开**创建存储桶**对话框。

1. 在 **Bucket Name（存储桶名称）**字段中，输入一个有效的存储桶名称。

   按下 **Enter** 键以创建存储桶并关闭对话框。然后，您的新存储桶将显示在 Toolkit 中的 Amazon S3 服务下。
**注意**  
由于 Amazon S3 允许您的存储桶用作可公开访问的 URL，因此您选择的存储桶名称必须具有全局唯一性。如果您想要使用的名称已被其他账户用于创建存储桶，那么您必须使用其他名称。  
如果您无法创建新的存储桶，可以检查**输出**选项卡中的 **AWS Toolkit 日志**。如果您尝试使用无效的存储桶名称，则会发生 `BucketAlreadyExists` 错误。  
有关更多信息，请参阅 **《Amazon Simple Storage Service 用户指南》**中的[存储桶限制](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html)。

## 在 Amazon S3 存储桶中添加文件夹
<a name="s3-service-resources-add-folder"></a>

您可以通过将对象分组到文件夹中来整理 S3 存储桶的内容。您也可以在文件夹中创建文件夹。

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

1. 选择**“创建文件夹”图标**，以打开**创建文件夹**对话框。或者，打开存储桶或文件夹的上下文菜单（右键单击），然后选择**创建文件夹**。

1. 在**文件夹名称**字段中输入一个值，然后按下 **Enter** 键以创建文件夹并关闭对话框。您的新文件夹显示在 Toolkit 菜单中相应的 Amazon S3 资源下。

## 删除 Amazon S3 存储桶
<a name="s3-service-resources-bucket-delete"></a>

删除 Amazon S3 存储桶时，还会删除其中包含的文件夹和对象。因此，当您尝试删除存储桶时，系统会要求您确认是否要删除它。

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

1. 打开存储桶或文件夹的上下文菜单（右键单击），然后选择**删除 Amazon S3 存储桶**。

1. 当系统提示时，在文本字段中输入存储桶的名称，然后按下 **Enter** 键以删除存储桶并关闭确认提示。
**注意**  
如果您的存储桶包含对象，则系统会在删除该存储桶之前将其清空。如果您尝试一次性删除大量资源或对象，则系统可能需要一些时间才会删除这些资源或对象。当这些资源或对象被删除后，系统会向您发送一条通知，告知您它们已被成功删除。

# 使用 Amazon S3 对象
<a name="s3-service-objects"></a>

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

以下各节介绍了如何通过 AWS Toolkit for Visual Studio Code使用 Amazon S3 对象。有关使用 Amazon S3 资源（例如 S3 存储桶）的详细信息 AWS Toolkit for Visual Studio Code，[请参阅本用户指南中的使用 S3 资源](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/s3-service.html)主题。

## 对象分页
<a name="s3-service-objects-pagination"></a>

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

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

1. 从 AWS Toolkit 扩展程序中，选择设置图标，然后选择**扩展设置**。

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

1. 在“加载更多”选项显示之前，将默认值更改为您要显示的 Amazon S3 项目数量。
**注意**  
有效值包括 3 到 1000 之间的任意数字。此设置仅适用于同时显示的对象或文件夹的数量。您创建的所有存储桶都会一次性显示。默认情况下，您可以在每个 AWS 账户中创建多达 100 个存储桶。

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

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

## 上传和下载 Amazon S3 对象
<a name="s3-service-objects-upload-download"></a>

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

### 使用 Toolkit 上传文件
<a name="s3-service-objects-upload-toolkit"></a>

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

1. 选择位于存储桶或文件夹旁边的**“上传文件”图标**，以打开**“上传文件”对话框**。或者，您也可以打开文件的上下文菜单（右键单击），然后选择**上传文件**。
**注意**  
要将文件上传到对象的父文件夹或资源，请打开任意 Amazon S3 对象的上下文菜单（右键单击），然后选择**上传至父级**。

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

### 使用“命令面板”上传文件
<a name="s3-service-objects-upload-commandpalette"></a>

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

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

1. 按下 **Ctrl\$1Shift\$1P** 以显示**命令面板**。

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

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

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

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

### 下载 Amazon S3 对象
<a name="s3-service-objects-download"></a>

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

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

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

## 编辑远程对象
<a name="s3-service-edit-objects"></a>

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

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

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

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

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

**注意**  
如果您重新启动或退出 VS Code，则您的 IDE 将会与 Amazon S3 资源断开连接。如果您断开连接时正在编辑任何远程 Amazon S3 文件，则编辑操作将会停止。您必须重新启动 VS Code 并重新打开编辑选项卡才能恢复编辑。
**编辑文件**按钮位于 UI 的右上角。只有当您在 VS Code 编辑器中主动查看只读文件时，它才可见。
无法以只读模式打开非文本文件。它们始终以编辑模式打开。
您无法从仅限编辑模式切换回只读模式，只能从只读模式切换回仅限编辑模式。

## 复制 Amazon S3 对象的路径
<a name="copy-path"></a>

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

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

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

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

## 为 Amazon S3 对象生成预签名 URL
<a name="presigned-s3-object"></a>

您可以通过预签名 URL 功能授予限时下载权限，从而与其他人共享私有 Amazon S3 对象。有关更多信息，请参阅[使用预签名 URL 共享对象](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html)。

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

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

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

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

## 删除 Amazon S3 对象
<a name="s3-service-delete-object"></a>

如果对象位于不受版本控制的存储桶中，您可以永久删除它。对于启用版本控制的存储桶，删除请求不会永久删除该对象。但是，Amazon S3 将在存储桶中插入一个删除标记。有关更多信息，请参阅[删除对象版本](https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectVersions.html)。

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

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

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