S3

El objeto que describe unS3tipo de origen de evento.

Sintaxis

Para declarar esta entidad en suAWS Serverless Application Model(AWS SAM), utilice la siguiente sintaxis.

YAML

  Bucket: String
  Events: String | List
  Filter: NotificationFilter

Properties

Bucket

Nombre del bucket de S3. Este bucket debe existir en la misma plantilla.

Type: Cadena

Obligatorio: Sí

AWS CloudFormationcompatibilidad: Esta propiedad es similar a laBucketNamepropiedad de unAWS::S3::Bucketrecurso. Este campo es obligatorio en SAM. Este campo solo acepta una referencia al bucket de S3 creado en esta plantilla

Events

El evento del bucket de Amazon S3 para el que se invoca la función Lambda. ConsulteTipos de eventos compatibles con Amazon S3para obtener una lista de valores válidos.

Type: Cadena | Lista

Obligatorio: Sí

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alEventpropiedad delAWS::S3::Bucket LambdaConfigurationTipos de datos de.

Filter

Las reglas de filtrado que determinan qué objetos de Amazon S3 invoca la función Lambda. Para obtener información sobre el filtrado de nombres de claves de Amazon S3, consulteConfiguración de notificaciones de eventos de Amazon S3en laAmazon Simple Storage Service Guide.

Type: NotificationFilter

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alFilterpropiedad delAWS::S3::Bucket LambdaConfigurationTipos de datos de.

Ejemplos

Evento de S3

Ejemplo de evento de 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