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

将访问点与兼容的 Amazon S3 操作结合使用

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

接入点与Amazon服务的兼容性

Amazon S3 接入点别名允许任何需要 S3 存储桶名称的应用程序轻松使用接入点。在使用 S3 存储桶名称访问 S3 中数据的任何位置,您都可以使用 S3 接入点别名。

接入点与 S3 操作的兼容性

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

S3 操作

通过访问点请求对象

以下示例通过区域 my-image.jpg 中的账户 ID prod 拥有的访问点 123456789012 来请求对象 us-west-2,并将下载的文件另存为 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

通过访问点删除对象

以下示例通过区域 my-image.jpg 中的账户 ID prod 拥有的访问点 123456789012 来删除对象 us-west-2

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

通过访问点向对象添加标签集

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

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 通过访问点授予访问权限

以下示例通过区域 my-image.jpg 中的账户 ID prod 拥有的访问点 123456789012 向现有对象 us-west-2 应用 ACL。

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