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::Bucket LambdaConfiguration データ型の Eventプロパティに直接渡されます。

Filter

どの Amazon S3 オブジェクトが Lambda 関数を呼び出すかを決定するフィルタリングルールです。Amazon S3 キー名によるフィルタリングの詳細については、Amazon Simple Storage Service ユーザーガイドで Amazon S3 イベント通知の設定を参照してください。

タイプ: NotificationFilter

必須: いいえ

AWS CloudFormation 互換性: このプロパティは、 AWS::S3::Bucket LambdaConfiguration データ型の 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