AWS::S3::Bucket ReplicationRule - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::S3::Bucket ReplicationRule

指定复制哪些 Amazon S3 对象以及在何处存储副本。

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

属性

DeleteMarkerReplication

指定 Amazon S3 是否复制删除标记。如果指定 Filter,则必须指定此元素。但是,在最新版本的复制配置(指定 Filter 时)中,Amazon S3 不复制删除标记。因此,DeleteMarkerReplication 元素只能包含<Status>已禁用</Status>。有关示例配置,请参阅基本规则配置

注意

如果未指定 Filter 元素,Amazon S3 会假定复制配置为早期版本 V1。在早期版本中,Amazon S3 以其他方式处理删除标记的复制。有关更多信息,请参阅向后兼容性

必需:否

类型DeleteMarkerReplication

Update requires: No interruption

Destination

提供有关复制目标及其配置的信息的容器,包括启用 S3 复制时间控制 (S3 RTC)。

必需:是

类型ReplicationDestination

Update requires: No interruption

Filter

标识应用复制规则的对象子集的筛选条件。Filter 必须指定确切一个 PrefixTagFilterAnd 子元素。

必需:否

类型ReplicationRuleFilter

Update requires: No interruption

Id

规则的唯一标识符。最大值为 255 个字符。如果您不指定值,AWS CloudFormation 会生成随机 ID。

必需:否

类型:字符串

Update requires: No interruption

Prefix

标识将规则应用到的一个或多个对象的对象键名称前缀。前缀的最大长度为 1024 个字符。要在存储桶中包含所有对象,指定空字符串。

必需:否

类型:字符串

Update requires: No interruption

Priority

与规则关联的优先级。如果您在复制配置中指定了多个规则,Amazon S3 会对规则进行优先排序,以防止在筛选时发生冲突。如果两个或更多规则基于指定的筛选条件标识同一个对象,则优先级较高的规则优先。例如:

  • 同一个对象限定基于前缀的筛选标准(如果在多个规则中指定的前缀重叠)

  • 同一个对象限定在多个规则中指定的基于标签的筛选标准

有关更多信息,请参阅 Amazon Simple Storage Service 开发人员指南 中的复制

必需:否

类型:整数

Update requires: No interruption

SourceSelectionCriteria

一个容器,描述额外的筛选条件以确定要复制的源对象。您可以选择允许或禁止复制这些对象。目前,Amazon S3 仅支持为使用具有 AWS Key Management Service 中存储的客户主密钥 (CMK) 的服务器端加密 (SSE-KMS) 创建的对象指定的筛选器。

必需:否

类型SourceSelectionCriteria

Update requires: No interruption

Status

指定是否启用规则。

必需:是

类型:字符串

允许的值Disabled | Enabled

Update requires: No interruption