本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 將 Amazon S3 Access Points 用於一般用途儲存貯體
下列範例展示如何在 Amazon S3 中搭配相容操作使用一般用途儲存貯體的存取點。
**注意**
S3 會自動為所有存取點產生存取點別名，而且這些別名可在儲存貯體名稱執行物件層級操作的任何地方使用。如需詳細資訊，請參閱[存取點別名](access-points-naming.md#access-points-alias)。
您只能使用一般用途儲存貯體的存取點在物件上執行操作。您無法使用存取點來執行其他 Amazon S3 操作，例如修改或刪除儲存貯體。如需支援存取點的 S3 操作完整清單，請參閱[存取點相容性](access-points-service-api-support.md)。
**Topics**
+ [
# 透過一般用途儲存貯體的存取點列出物件
](list-object-ap.md)
+ [
# 透過一般用途儲存貯體的存取點下載物件
](get-object-ap.md)
+ [
# 透過一般用途儲存貯體的存取點設定存取控制清單 (ACL)
](put-acl-permissions-ap.md)
+ [
# 透過一般用途儲存貯體的存取點上傳物件
](put-object-ap.md)
+ [
# 透過一般用途儲存貯體的存取點新增標籤集
](add-tag-set-ap.md)
+ [
# 透過一般用途儲存貯體的存取點刪除物件
](delete-object-ap.md)
# 透過一般用途儲存貯體的存取點列出物件
本節說明如何使用 AWS Command Line Interface、 或 REST API AWS 管理主控台，透過一般用途儲存貯體的存取點列出物件。
## 使用 S3 主控台
**透過 中的存取點列出物件 AWS 帳戶**
1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)：// 開啟 Amazon S3 主控台。
1. 在頁面頂端的導覽列中，選擇目前顯示的名稱 AWS 區域。接下來，選擇您要列出存取點的區域。
1. 在主控台左側的導覽窗格中，選擇**存取點**。
1. (選用) 依名稱搜尋存取點。只有所選存取點 AWS 區域 才會顯示在這裡。
1. 選擇存取點的名稱以管理或使用此存取點。
1. 在**物件**標籤下，選擇您要透過存取點存取的物件名稱。當您使用存取點時，只能執行存取點許可所允許的物件操作。
**注意**
主控台視圖一律會顯示儲存貯體中的所有物件。如此程序所述使用存取點會限制您可以在這些物件上執行的操作，但不會限制您是否能看到它們存在於儲存貯體中。
AWS 管理主控台 不支援使用虛擬私有雲端 (VPC) 存取點存取儲存貯體資源。若要從 VPC 存取點存取儲存貯體資源，請使用 AWS CLI、 AWS SDKs或 Amazon S3 REST APIs。
## 使用 AWS CLI
下列`list-objects-v2`範例命令示範如何使用 AWS CLI 來透過存取點列出物件。
下列命令使用存取點 *my-access-point*，列出 AWS 帳戶 *111122223333* 的物件。
```
aws s3api list-objects-v2 --bucket arn:aws:s3:AWS 區域:111122223333:accesspoint/my-access-point
```
**注意**
S3 會自動為所有存取點產生存取點別名，而且這些別名可在儲存貯體名稱執行物件層級操作的任何地方使用。如需詳細資訊，請參閱[存取點別名](access-points-naming.md#access-points-alias)。
如需詳細資訊和範例，請參閱AWS CLI 命令參考**中的 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/list-objects-v2.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/list-objects-v2.html)。
## 使用 REST API
您可以使用 REST API 列出您的存取點。如需詳細資訊，請參閱《Amazon Simple Storage Service API 參考》**中的 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html)。
# 透過一般用途儲存貯體的存取點下載物件
本節說明如何使用 AWS Command Line Interface、 AWS 管理主控台或 REST API 透過一般用途儲存貯體的存取點下載物件。
## 使用 S3 主控台
**透過 中的存取點下載物件 AWS 帳戶**
1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 開啟 Amazon S3 主控台。
1. 在頁面頂端的導覽列中，選擇目前顯示的名稱 AWS 區域。接下來，選擇您要列出存取點的區域。
1. 在主控台左側的導覽窗格中，選擇**存取點**。
1. (選用) 依名稱搜尋存取點。只有所選存取點 AWS 區域 才會顯示在這裡。
1. 選擇存取點的名稱以管理或使用此存取點。
1. 在**物件**索引標籤下，選取您要下載的物件名稱。
1. 選擇 **Download** (下載)。
## 使用 AWS CLI
下列`get-object`範例命令顯示如何使用 AWS CLI ，透過存取點下載物件。
下列命令會使用存取點 *my-access-point* 下載 AWS 帳戶 *111122223333* 的物件 `puppy.jpg`。您必須包含 `outfile`，這是下載物件的檔案名稱，例如 `my_downloaded_image.jpg`。
```
aws s3api get-object --bucket arn:aws:s3:AWS 區域:111122223333:accesspoint/my-access-point --key puppy.jpg my_downloaded_image.jpg
```
**注意**
S3 會自動為所有存取點產生存取點別名，而且這些別名可在儲存貯體名稱執行物件層級操作的任何地方使用。如需詳細資訊，請參閱[存取點別名](access-points-naming.md#access-points-alias)。
如需詳細資訊和範例，請參閱AWS CLI 命令參考**中的 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-object.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-object.html)。
## 使用 REST API
您可以使用 REST API 透過存取點下載物件。如需詳細資訊，請參閱《Amazon Simple Storage Service API 參考》**中的 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)。
## 使用 AWS SDKs
您可以使用適用於 Python 的 AWS SDK，透過存取點下載物件。
------
#### [ Python ]
在下列範例中，使用名為 *my-access-point* 的存取點，為 AWS 帳戶 *111122223333* `hello.txt`下載名為 的檔案。
```
import boto3
s3 = boto3.client('s3')
s3.download_file('arn:aws:s3:us-east-1:111122223333:accesspoint/my-access-point', 'hello.txt', '/tmp/hello.txt')
```
------
# 透過一般用途儲存貯體的存取點設定存取控制清單 (ACL)
本節說明如何使用 AWS Command Line Interface、 AWS 管理主控台或 REST API，透過一般用途儲存貯體的存取點設定 ACLs。如需 ACL 的詳細資訊，請參閱「[存取控制清單 (ACL) 概觀](acl-overview.md)」。
## 使用 S3 主控台
**透過 中的存取點設定 ACLs AWS 帳戶**
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 的 Amazon S3 主控台。
1. 在頁面頂端的導覽列中，選擇目前顯示的名稱 AWS 區域。接下來，選擇您要列出存取點的區域。
1. 在主控台左側的導覽窗格中，選擇**存取點**。
1. (選用) 依名稱搜尋存取點。只有所選存取點 AWS 區域 才會顯示在這裡。
1. 選擇存取點的名稱以管理或使用此存取點。
1. 在**物件**索引標籤下，選取您要為其設定 ACL 的物件名稱。
1. 在**許可**索引標籤下，選取**編輯**以設定物件 ACL。
**注意**
Amazon S3 目前不支援在建立存取點後變更存取點的封鎖公開存取權限設定。
## 使用 AWS CLI
下列`put-object-acl`範例命令示範如何使用 AWS CLI ，透過使用 ACL 的存取點設定存取許可。
下列命令示範如何透過 AWS 帳戶 *111122223333* 擁有的存取點，將 ACL 套用至現有的物件 `puppy.jpg`。
```
aws s3api put-object-acl --bucket arn:aws:s3:AWS 區域:111122223333:accesspoint/my-access-point --key puppy.jpg --acl private
```
**注意**
S3 會自動為所有存取點產生存取點別名，而且這些別名可在儲存貯體名稱執行物件層級操作的任何地方使用。如需詳細資訊，請參閱[存取點別名](access-points-naming.md#access-points-alias)。
如需詳細資訊和範例，請參閱AWS CLI 命令參考**中的 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object-acl.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object-acl.html)。
## 使用 REST API
您可以使用 REST API，透過使用 ACL 的存取點設定存取權限。如需詳細資訊，請參閱《Amazon Simple Storage Service API 參考》**中的 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectAcl.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectAcl.html)。
# 透過一般用途儲存貯體的存取點上傳物件
本節說明如何使用 AWS Command Line Interface、 AWS 管理主控台或 REST API，透過一般用途儲存貯體的存取點上傳物件。
## 使用 S3 主控台
**透過 中的存取點上傳物件 AWS 帳戶**
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 的 Amazon S3 主控台。
1. 在頁面頂端的導覽列中，選擇目前顯示的名稱 AWS 區域。接下來，選擇您要列出存取點的區域。
1. 在主控台左側的導覽窗格中，選擇**存取點**。
1. (選用) 依名稱搜尋存取點。只有所選存取點 AWS 區域 才會顯示在這裡。
1. 選擇存取點的名稱以管理或使用此存取點。
1. 在**物件**索引標籤下，選取**上傳**。
1. 將您要上傳的檔案和資料夾拖放至此處，或選擇**新增檔案**或**新增資料夾**。
**注意**
使用 Amazon S3 主控台可上傳的檔案大小上限為 160 GB。若要上傳大於 160 GB 的檔案，請使用 AWS Command Line Interface (AWS CLI)、 AWS SDKs或 Amazon S3 REST API。
1. 若要變更存取控制清單許可，請選擇**Permissions** (許可)。
1. 在**存取控制清單 (ACL)**中，編輯許可。
如需物件存取許可的資訊，請參閱「[使用 S3 主控台來設定物件的 ACL 許可](managing-acls.md#set-object-permissions)」。您可以針對您上傳的所有檔案，將物件的讀取存取許可授予大眾 (全世界的所有人)。但是，建議不要變更公有讀取存取的預設設定。授予公有讀取存取適用於一小部分的使用情況，例如當儲存貯體用於網站時。您一律可以在上傳物件之後變更物件許可。
1. 若要設定其他附加屬性，請選擇**Properties** (屬性)。
1. 在**儲存類別**下，選擇您要上傳的檔案的儲存類別。
如需儲存體方案的詳細資訊，請參閱「[了解和管理 Amazon S3 儲存類別](storage-class-intro.md)」。
1. 若要更新物件的加密設定，請在 **Server-side encryption settings** (伺服器端加密設定) 下，執行下列操作。
1. 選擇 **Specify an encryption key** (指定加密金鑰)。
1. 在**加密設定**底下，選擇**使用預設加密的儲存貯體設定**或**覆寫預設加密的儲存貯體設定**。
1. 若您選擇**覆寫預設加密的儲存貯體設定**，則您必須設定下列加密設定。
+ 若要使用 Amazon S3 管理的金鑰加密上傳的檔案，請選擇 **Amazon S3 受管金鑰 (SSE-S3)**。
如需詳細資訊，請參閱[使用 Amazon S3 受管金鑰 (SSE-S3) 進行伺服器端加密](UsingServerSideEncryption.md)。
+ 若要使用儲存在 AWS Key Management Service () 中的金鑰來加密上傳的檔案AWS KMS，請選擇**AWS Key Management Service 金鑰 (SSE-KMS)**。然後針對 **AWS KMS 金鑰**，選擇下列其中一個選項：
+ 若要從可用的 KMS 金鑰清單中選擇，請選擇**從 AWS KMS keys中選擇**，然後從可用金鑰清單中選擇您的 **KMS 金鑰**。
AWS 受管金鑰 (`aws/s3`) 和您的客戶受管金鑰都會顯示在此清單中。如需詳細了解客戶受管金鑰，請參閱《AWS Key Management Service 開發人員指南》**中的[客戶金鑰和 AWS 金鑰](https://docs.aws.amazon.com//kms/latest/developerguide/concepts.html#key-mgmt)。
+ 若要輸入 KMS 金鑰 ARN，請選擇**輸入 AWS KMS key ARN**，然後在出現的欄位中輸入您的 KMS 金鑰 ARN。
+ 若要在 AWS KMS 主控台中建立新的客戶受管金鑰，請選擇**建立 KMS 金鑰**。
如需建立 的詳細資訊 AWS KMS key，請參閱《 *AWS Key Management Service 開發人員指南*》中的[建立金鑰](https://docs.aws.amazon.com//kms/latest/developerguide/create-keys.html)。
**重要**
您只能使用 AWS 區域 與儲存貯體相同的 KMS 金鑰。Amazon S3 主控台僅會列出與儲存貯體位於相同區域的前 100 個 KMS 金鑰。若要使用未列出的 KMS 金鑰，必須輸入 KMS 金鑰 ARN。若您想要使用其他帳戶的 KMS 金鑰，您必須先具有該金鑰的使用權限，然後輸入 KMS 金鑰 ARN。
Amazon S3 僅支援對稱加密 KMS 金鑰，而不支援非對稱 KMS 金鑰。如需詳細資訊，請參閱《AWS Key Management Service 開發人員指南》**中的[識別對稱和非對稱 KMS 金鑰](https://docs.aws.amazon.com//kms/latest/developerguide/find-symm-asymm.html)。
1. 若要使用額外的檢查總和，請選擇 **On** (開啟)。然後為 **檢查總和函數**，選擇您要使用的函數。Amazon S3 在接收完整物件後計算並存儲檢查總和的值。您可以使用 **預先計算的值** 方塊以提供預先計算的值。如果您這樣做，Amazon S3 會將您提供的值與其計算的值進行比較。如果兩個值不匹配，Amazon S3 將產生錯誤。
通過額外的檢查總和，您可以指定要用於驗證資料的檢查總合演算法。如需額外的檢查總和詳細資訊，請參閱「[在 Amazon S3 中檢查物件完整性](checking-object-integrity.md)」。
1. 若要將標籤新增至您要上傳的所有物件，請選擇 **Add tag** (新增標籤)。在**金鑰**欄位中輸入標籤名稱。輸入標籤值。
物件標記提供您一個分類儲存的方法。每個標籤都是金鑰值對。金鑰與標記值皆區分大小寫。每物件最多可有 10 個標籤。標籤金鑰最長可包含 128 個 Unicode 字元；標籤值最長可包含 255 個 Unicode 字元。如需物件標籤的詳細資訊，請參閱 [使用標籤為物件分類](object-tagging.md)。
1. 若要新增中繼資料，請選擇 **Add metadata** (新增中繼資料)。
1. 在 **Type** (類型) 下，選擇 **System defined** (系統定義) 或 **User defined** (使用者定義)。
對於系統定義的中繼資料，您可以選取常見的 HTTP 標頭，例如 **Content-Type** 和 **Content-Disposition**。如需系統定義的中繼資料清單及是否可新增值的資訊，請參閱「[系統定義的物件中繼資料](UsingMetadata.md#SysMetadata)」。以字首 `x-amz-meta-` 開頭的所有中繼資料都會視為使用者定義的中繼資料。使用者定義的中繼資料會與 物件一起存放，並在下載物件時傳回。金鑰及其值都必須符合 US-ASCII 標準。使用者定義的中繼資料最大可達 2 KB。如需系統定義與使用者定義中繼資料的詳細資訊，請參閱 「[使用物件中繼資料](UsingMetadata.md)」。
1. 針對 **Key** (金鑰) 中，選擇一個金鑰。
1. 輸入金鑰的值。
1. 若要上傳物件，請選擇 **Upload** (上傳)。
Amazon S3 會上傳您的物件。上傳完成後，您可以在 **Upload: status** (上傳：狀態) 頁面上看到成功訊息。
## 使用 AWS CLI
下列`put-object`範例命令顯示如何使用 AWS CLI ，透過存取點上傳物件。
下列命令會使用存取點 *my-access-point* 上傳 AWS 帳戶 *111122223333* 的物件 `puppy.jpg`。
```
aws s3api put-object --bucket arn:aws:s3:AWS 區域:111122223333:accesspoint/my-access-point --key puppy.jpg --body puppy.jpg
```
**注意**
S3 會自動為所有存取點產生存取點別名，而且存取點別名可在儲存貯體名稱執行物件層級操作的任何地方使用。如需詳細資訊，請參閱[存取點別名](access-points-naming.md#access-points-alias)。
如需詳細資訊和範例，請參閱AWS CLI 命令參考**中的 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object.html)。
## 使用 REST API
您可以使用 REST API 透過存取點上傳物件。如需詳細資訊，請參閱《Amazon Simple Storage Service API 參考》**中的 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)。
## 使用 AWS SDKs
您可以使用適用於 Python 的 AWS SDK 透過存取點上傳物件。
------
#### [ Python ]
在下列範例中，使用名為 *my-access-point* 的存取點為 AWS 帳戶 *111122223333* `hello.txt`上傳名為 的檔案。
```
import boto3
s3 = boto3.client('s3')
s3.upload_file('/tmp/hello.txt', 'arn:aws:s3:us-east-1:111122223333:accesspoint/my-access-point', 'hello.txt')
```
------
# 透過一般用途儲存貯體的存取點新增標籤集
本節說明如何使用 AWS Command Line Interface AWS 管理主控台、 或 REST API，透過一般用途儲存貯體的存取點新增標籤集。如需詳細資訊，請參閱[使用標籤為物件分類](object-tagging.md)。
## 使用 S3 主控台
**透過 中的存取點新增標籤集 AWS 帳戶**
1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 開啟 Amazon S3 主控台。
1. 在頁面頂端的導覽列中，選擇目前顯示的名稱 AWS 區域。接下來，選擇您要列出存取點的區域。
1. 在主控台左側的導覽窗格中，選擇**存取點**。
1. (選用) 依名稱搜尋存取點。只有所選存取點 AWS 區域 才會顯示在這裡。
1. 選擇存取點的名稱以管理或使用此存取點。
1. 在**物件**索引標籤下，選取您要為其新增標籤集的物件名稱。
1. 在**屬性**索引標籤下，尋找**標籤**子標頭，然後選擇**編輯**。
1. 檢閱列出的物件，然後選擇**新增標籤**。
1. 每個物件標籤都是金鑰/值對。輸入 **Key (索引鍵)** 和 **Value (數值)**。若要新增其他標籤，選擇 **Add Tag (新增標籤)**。
一個物件最多可以輸入 10 個標籤。
1. 選擇 **Save changes** (儲存變更)。
## 使用 AWS CLI
下列`put-object-tagging`範例命令顯示如何使用 AWS CLI ，透過存取點新增標籤集。
下列命令會使用存取點 *my-access-point*，為現有物件 `puppy.jpg` 新增標籤集。
```
aws s3api put-object-tagging --bucket arn:aws:s3:AWS 區域:111122223333:accesspoint/my-access-point --key puppy.jpg --tagging TagSet=[{Key="animal",Value="true"}]
```
**注意**
S3 會自動為所有存取點產生存取點別名，而且存取點別名可在儲存貯體名稱執行物件層級操作的任何地方使用。如需詳細資訊，請參閱[存取點別名](access-points-naming.md#access-points-alias)。
如需詳細資訊和範例，請參閱AWS CLI 命令參考**中的 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object-tagging.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object-tagging.html)。
## 使用 REST API
您可以使用 REST API，透過存取點將標籤集新增至物件。如需詳細資訊，請參閱《Amazon Simple Storage Service API 參考》**中的 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html)。
# 透過一般用途儲存貯體的存取點刪除物件
本節說明如何使用 AWS Command Line Interface、 AWS 管理主控台或 REST API，透過一般用途儲存貯體的存取點刪除物件。
## 使用 S3 主控台
**透過 中的存取點刪除物件 AWS 帳戶**
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 的 Amazon S3 主控台。
1. 在頁面頂端的導覽列中，選擇目前顯示的名稱 AWS 區域。接下來，選擇您要列出存取點的區域。
1. 在主控台左側的導覽窗格中，選擇**存取點**。
1. (選用) 依名稱搜尋存取點。只有所選存取點 AWS 區域 才會顯示在這裡。
1. 選擇存取點的名稱以管理或使用此存取點。
1. 在**物件**索引標籤下，選取您想要刪除的物件名稱。
1. 檢閱為刪除而列出的物件，然後在確認方塊中輸入 *delete*。
1. 選擇 **Delete objects** (刪除物件)。
## 使用 AWS CLI
下列`delete-object`範例命令顯示如何使用 AWS CLI 來透過存取點刪除物件。
下列命令會使用存取點 *my-access-point* 刪除現有物件 `puppy.jpg`。
```
aws s3api delete-object --bucket arn:aws:s3:AWS 區域:111122223333:accesspoint/my-access-point --key puppy.jpg
```
**注意**
S3 會自動為所有存取點產生存取點別名，而且存取點別名可在儲存貯體名稱執行物件層級操作的任何地方使用。如需詳細資訊，請參閱[存取點別名](access-points-naming.md#access-points-alias)。
如需詳細資訊和範例，請參閱AWS CLI 命令參考**中的 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/delete-object.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/delete-object.html)。
## 使用 REST API
您可以使用 REST API 以透過存取點刪除物件。如需詳細資訊，請參閱《Amazon Simple Storage Service API 參考》**中的 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)。