Amazon Simple Storage Service
开发人员指南 (API 版本 2006-03-01)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

Put 对象标记

Put 对象标记操作取代清单中列出的各个对象的 Amazon S3 对象标签。Amazon S3 对象标签是一个字符串的键/值对,您可用它来存储有关对象的元数据。

要创建 Put 对象标记作业,您需要提供所要应用的标签集。Amazon S3 批处理操作将相同的标签集应用到各个对象。您提供的标签集替换已经与清单中对象关联的所有标签集。Amazon S3 批处理操作不支持将标签添加到对象并原样保留现有的标签。

如果清单中的对象位于受版本控制的存储桶中,您可将标签集应用到各个对象到特定版本。您通过为清单中的每个对象指定版本 ID 来完成此操作。如果您没有包括任何对象的版本 ID,则 Amazon S3 批处理操作将标签集应用到各个对象的最新版本。

限制

  • 您指定用于运行 Put 对象标记作业的角色必须有权执行基础 Amazon S3 Put 对象标记操作。有关所需权限的更多信息,请参阅 Amazon Simple Storage Service API Reference 中的 PUT 对象标记

  • Amazon S3 批处理操作使用 Amazon S3 PUT 对象标记操作,将标签应用到清单中的各个对象。因此,适用于基础 PUT 对象标记操作的所有限制也适用于 Amazon S3 批处理操作 Put 对象标记作业。有关更多信息,请参阅本页面的相关资源部分。

本页内容: