将接入点与兼容的 Amazon S3 操作结合使用 - Amazon Simple Storage Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

将接入点与兼容的 Amazon S3 操作结合使用

以下示例演示如何在 Amazon S3 中将接入点与兼容操作结合使用。

接入点与Amazon服务的兼容性

Amazon S3 接入点别名允许需要 S3 存储桶名称的应用程序轻松使用接入点。在使用 S3 存储桶名称访问 S3 中数据的位置,您可以使用 S3 接入点别名。有关更多信息,请参阅接入点别名使用案例和限制条件

接入点与 S3 操作的兼容性

您可以使用 Amazon S3 API 的以下子集通过接入点来访问存储桶:下列所有操作都可以接受接入点 ARN 或接入点别名:

S3 操作

通过接入点请求对象

以下示例通过区域 us-west-2 中的账户 ID 123456789012 拥有的接入点 prod 来请求对象 my-image.jpg,并将下载的文件另存为 download.jpg

Amazon 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

Amazon 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

Amazon 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 来列出对象。

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

通过接入点向对象添加标签集

以下示例通过区域 us-west-2 中的账户 ID 123456789012 拥有的接入点 prod 向现有对象 my-image.jpg 添加标签集。

Amazon 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 向现有对象 my-image.jpg 应用 ACL。

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