Skip to content
v2.273.0

S3FilesConfigProperty Struct ​

Setting controls how your function accesses data from an Amazon S3 file system.

Example ​

ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_lambda as lambda } from 'aws-cdk-lib';
const s3FilesConfigProperty: lambda.CfnFunction.S3FilesConfigProperty = {
  directS3Read: 'directS3Read',
};

Properties ​

directS3Readstringdirect_s3_readstrdirectS3ReadStringDirectS3ReadstringDirectS3Read*string#
Specifies if a function reads from the file system for the lowest latency, or through Amazon S3 Files feature "direct Amazon S3 bucket reads" for the highest throughput.
notes

Valid values:

  • AUTO (default) – Direct reads are active for functions you configure with 512 MB or more of memory.
  • ENABLED – Enforces all reads are directly from the Amazon S3 bucket, regardless of available memory (less than 512 MB).
  • DISABLED – Routes all reads through the file system, regardless of memory configuration.

To use direct reads, you must grant the execution role the s3:GetObject and s3:GetObjectVersion permissions. If a direct read fails, Lambda automatically falls back to reading through the file system.