S3 - AWS Serverless Application Model
语法属性示例
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

S3

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

语法

在您的 中声明此实体 AWS 无服务器应用程序模型 （AWS SAM） 模板时，请使用以下语法。

YAML

  Bucket: String
  Events: String | List
  Filter: NotificationFilter

属性

Bucket

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

类型：字符串

必需: 是

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

Events

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

类型：String | List

必需: 是

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

Filter

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

类型: NotificationFilter

必需: 否

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

示例

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