S3

描述 S3 事件源类型的对象。

语法

要在 AWS Serverless Application Model (AWS SAM) 模板中声明此实体，请使用以下语法。

YAML

  Bucket: String
  Events: String | List
  Filter: NotificationFilter

属性

Bucket

S3 桶名称。此存储桶必须存在于同一模板中。

类型：字符串

必需：是

AWS CloudFormation 兼容性：此属性类似于AWS::S3::Bucket资源的BucketName属性。在 SAM 中此为必填字段。此字段仅接受对此模板中创建的 S3 存储桶的引用

Events

调用 Lambda 函数的 Amazon S3 桶事件。有关有效值的列表，请参阅 Amazon S3 支持的事件类型。

类型：字符串 | 列表

必需：是

AWS CloudFormation 兼容性：此属性直接传递给AWS::S3::BucketLambdaConfiguration数据类型的Event属性。

Filter

确定哪些 Amazon S3 对象调用 Lambda 函数的筛选规则。有关 Amazon S3 键名筛选的信息，请参阅《Amazon Simple Storage Service 用户指南》中的配置 Amazon S3 事件通知。

类型:NotificationFilter

必需：否

AWS CloudFormation 兼容性：此属性直接传递给AWS::S3::BucketLambdaConfiguration数据类型的Filter属性。

示例

S3 事件

S3 事件示例。

YAML

Events:
  S3Event:
    Type: S3
    Properties:
      Bucket:
        Ref: ImagesBucket     # This must be the name of an S3 bucket declared in the same template file
      Events: s3:ObjectCreated:*
      Filter:
        S3Key:
          Rules:
          - Name: prefix      # or "suffix"
            Value: value      # The value to search for in the S3 object key names