使用存取點進行相容的 Amazon S3 操作 - Amazon Simple Storage Service

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

使用存取點進行相容的 Amazon S3 操作

下列範例示範如何在 Amazon S3 中搭配相容操作使用存取點。

存取點與 AWS 服務的相容性

Amazon S3 存取點別名允許需要 S3 儲存貯體名稱的應用程式,輕鬆使用存取點。您可以在使用 S3 存取點名稱的任何位置,使用 S3 儲存貯體名稱來存取 S3 中的資料。如需詳細資訊,請參閱 存取點別名使用案例和限制

存取點與 S3 操作的相容性

您可以使用下列 Amazon S3 API 子集,透過存取點來存取儲存貯體:下列所有操作都可以接受存取點 ARN 或存取點別名:

S3 操作

透過存取點要求物件

下列範例會透過區域 us-west-2 中帳戶 ID 123456789012 所擁有的存取點 prod 要求 my-image.jpg 物件,並將下載的檔案儲存為 download.jpg

AWS CLI
aws s3api get-object --key my-image.jpg --bucket arn:aws:s3:us-west-2:123456789012:accesspoint/prod download.jpg

透過存取點上傳物件

下列範例會透過區域 us-west-2 中帳戶 ID 123456789012 所擁有的存取點別名 my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias 來上傳物件 my-image.jpg

AWS CLI
aws s3api put-object --bucket my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias --key my-image.jpg --body my-image.jpg

透過存取點刪除物件

下列範例會透過區域 us-west-2 中帳戶 ID 123456789012 所擁有的存取點 prod 刪除物件 my-image.jpg

AWS CLI
aws s3api delete-object --bucket arn:aws:s3:us-west-2:123456789012:accesspoint/prod --key my-image.jpg

透過存取點別名列出物件

下列範例會透過區域 us-west-2 中帳戶 ID 123456789012 所擁有的存取點別名 my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias 來列出物件。

AWS CLI
aws s3api list-objects-v2 --bucket my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias

透過存取點將標籤集新增至物件

下列範例透過區域 us-west-2 中帳戶 ID 123456789012 所擁有的存取點 prod 新增標籤集至現有的物件 my-image.jpg

AWS CLI
aws s3api put-object-tagging --bucket arn:aws:s3:us-west-2:123456789012:accesspoint/prod --key my-image.jpg --tagging TagSet=[{Key="finance",Value="true"}]

透過使用 ACL 的存取點授予許可

下列範例示範如何透過區域 us-west-2 中帳戶 ID 123456789012 所擁有的存取點 prod 套用 ACL 至現有的物件 my-image.jpg

AWS CLI
aws s3api put-object-acl --bucket arn:aws:s3:us-west-2:123456789012:accesspoint/prod --key my-image.jpg --acl private