本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

存放在 S3 資源儲存貯體中的檔案、資料夾和任何其他資料稱為 S3 物件。

下列各節說明如何從 使用 Amazon S3 物件 AWS Toolkit for Visual Studio Code。如需使用 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 程式碼**活動列**，然後選擇**延伸。**

1. 從 AWS 工具組擴充功能中，選擇設定圖示，然後選擇**擴充功能設定**。

1. 在**設定**頁面上，向下捲動至 **AWS > S3：每頁項目上限**設定。

1. 將預設值變更為您希望在顯示「載入更多」之前顯示的 S3 項目數量。
**注意**  
有效值包含 3 到 1000 之間的任何數字。此設定僅適用於一次顯示的物件或資料夾數量。您建立的所有儲存貯體都會一次顯示。每個 AWS 帳戶預設最多可以建立 100 個儲存貯體。

1. 關閉**設定**頁面以確認您的變更。

您也可以選擇設定頁面右上角的**開啟設定 (JSON)** 圖示，以更新 JSON 格式檔案中**的設定**。

## 上傳和下載 Amazon S3 物件
<a name="s3-service-objects-upload-download"></a>

您可以將本機儲存的檔案上傳至 Amazon S3 儲存貯體，或從 下載遠端 Amazon S3 物件到您的本機系統 AWS Toolkit for Visual Studio Code。

### 使用 Toolkit 上傳檔案
<a name="s3-service-objects-upload-toolkit"></a>

1. 從 Toolkit Explorer 展開 **Amazon S3** 服務，以檢視您的 S3 資源清單。

1. 選擇位於儲存貯體或資料夾旁的**上傳檔案圖示**，以開啟**上傳檔案對話方塊**。或者，您可以開啟內容 （按一下滑鼠右鍵） 選單，然後選擇**上傳檔案**。
**注意**  
若要將檔案上傳至物件的父資料夾或資源，請開啟任何 S3 物件的內容 （按一下滑鼠右鍵） 選單，然後選擇**上傳至父**系。

1. 使用您系統的檔案管理員選取檔案，然後選擇**上傳檔案**以關閉對話方塊並上傳檔案。

### 使用命令面板上傳檔案
<a name="s3-service-objects-upload-commandpalette"></a>

您可以使用 Toolkit 界面或 **Command Palette** 將檔案上傳至儲存貯體。

1. 若要選取要上傳的檔案，請在 VS 程式碼中選擇該檔案的標籤。

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

1. 在**命令面板**中，輸入 片語`upload file`以顯示建議的命令清單。

1. 選擇 **AWS： Upload File** 命令以開啟 **AWS： Upload File** 對話方塊。

1. 出現提示時，請選擇您要上傳的檔案，然後選擇您要上傳該檔案的儲存貯體。

1. 確認您的上傳以關閉對話方塊，並開始上傳程序。上傳完成時，物件會顯示在工具組功能表中，其中包含包含物件大小、上次修改日期和路徑的中繼資料。

### 下載 Amazon S3 物件
<a name="s3-service-objects-download"></a>

1. 從 Toolkit Explorer 中，展開 **S3** 服務。

1. 從儲存貯體或資料夾，開啟您要下載之物件的內容 （按一下滑鼠右鍵） 選單。然後，選擇**下載為**以開啟下載為對話方塊。或者，選擇物件附近的**下載為**圖示。

1. 使用系統的檔案管理員，選擇目的地資料夾，輸入檔案名稱，然後選擇**下載**以關閉對話方塊並開始下載。

## 編輯遠端物件
<a name="s3-service-edit-objects"></a>

您可以使用 AWS Toolkit for Visual Studio Code 編輯存放在遠端 Amazon S3 資源中的 Amazon S3 物件。

1. 從 Toolkit Explorer 中，展開 **S3** 服務。

1. 展開包含您要編輯之檔案的 S3 資源。

1. 若要編輯檔案，請選擇**鉛筆圖示 （編輯檔案）**。

1. 若要編輯以唯讀模式開啟的檔案，請在 VS 程式碼編輯器中檢視檔案，然後選擇 UI 右上角的**鉛筆圖示**。

**注意**  
如果您重新啟動或結束 VS 程式碼，IDE 會中斷與 S3 資源的連線。如果中斷連線時正在編輯任何遠端 S3 檔案，則編輯會停止。您必須重新啟動 VS 程式碼並重新開啟編輯索引標籤，才能繼續編輯。
**編輯檔案**按鈕位於 UI 的右上角。只有在您主動在 VS 程式碼編輯器中檢視唯讀檔案時，才會顯示。
無法以唯讀模式開啟非文字檔案。它們一律以編輯模式開啟。
您無法從編輯唯讀模式切換回唯讀模式，只能切換到其他方向。

## 複製 Amazon S3 物件的路徑
<a name="copy-path"></a>

下列程序說明如何從 複製 Amazon S3 物件的路徑 AWS Toolkit for Visual Studio Code。

1. 從 Toolkit Explorer 中，展開 **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 Explorer 中，展開 **S3** 服務。

1. 從儲存貯體或資料夾，開啟您要共用之物件的內容 （按一下滑鼠右鍵） 選單。然後，選擇**產生預先簽章的 URL** 以開啟**命令面板**。

1. 從**命令面板**中，輸入 URL 可用來存取物件的分鐘數。然後，選擇 **Enter** 以確認並關閉對話方塊。

1. 產生預先簽章的 URL 後，VS 程式碼**狀態列**會顯示已複製到本機**剪貼簿**之物件的預先簽章 URL。

## 刪除 Amazon S3 物件
<a name="s3-service-delete-object"></a>

如果物件位於非版本控制的儲存貯體中，您可以永久刪除它。對於已啟用版本控制的儲存貯體，刪除請求不會永久刪除該物件。相反地，Amazon S3 會在儲存貯體中插入刪除標記。如需詳細資訊，請參閱[刪除物件版本](https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectVersions.html)。

1. 從 Toolkit Explorer 中，展開 **S3** 服務以檢視 S3 資源的清單。

1. 開啟您要刪除之物件的內容 （按一下滑鼠右鍵） 選單，然後選擇**刪除**以開啟確認對話方塊。

1. 選擇**刪除。 . .** 以確認您想要刪除 S3 物件。然後，關閉對話方塊。