S3 - Amazon Serverless Application Model
SyntaxPropertiesExamples
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

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

S3

描述S3事件源类型。

Syntax

要在您的Amazon Serverless Application Model(Amazon SAM) 模板，请使用以下语法。

YAML

  Bucket: String
  Events: String | List
  Filter: NotificationFilter

Properties

Bucket

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

类型：String

必需：是

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

Events

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

类型：字符串 | 列表

必需：是

Amazon CloudFormation兼容性：此属性将直接传递给Event的财产AWS::S3::Bucket LambdaConfiguration数据类型。

Filter

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

类型：NotificationFilter

必需：否

Amazon CloudFormation兼容性：此属性将直接传递给Filter的财产AWS::S3::Bucket LambdaConfiguration数据类型。

Examples

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