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

# 使用 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 对象。然后，关闭对话框。