Document history for AWS SAM
The following table describes the important changes in each release of the AWS Serverless Application Model Developer Guide. For notifications about updates to this documentation, you can subscribe to an RSS feed.
-
Latest documentation update: October 9, 2026
| Change | Description | Date |
|---|---|---|
Added AWS SAM CLI support for building and deploying Lambda Web Functions | The AWS SAM CLI can now build an | October 22, 2026 |
Added the AWS::Serverless::WebFunction resource | Use | October 12, 2026 |
Added OAuth 2.0 and IAM authentication types for SelfManagedKafka event sources | The | October 8, 2026 |
Added the ManagedResourceTags property for AWS::Serverless::CapacityProvider | Apply explicit tags to the Amazon Elastic Compute Cloud instances and other managed resources that a capacity provider provisions on your behalf. To learn more, see ManagedResourceTags. | August 25, 2026 |
Added the LoggingConfig property for AWS::Serverless::CapacityProvider | Configure system logging for a capacity provider, so that scaling activity and operational events go to a Amazon CloudWatch log group at a configurable log level. To learn more, see AWS::Serverless::CapacityProvider. | August 24, 2026 |
Added the --output option for AWS SAM CLI commands | Specify | August 19, 2026 |
Added the StorageMode property for function code and layer content | Control whether Lambda stores a copy of your deployment package or references it from your Amazon S3 bucket. To learn more, see FunctionCode and LayerContent. | August 4, 2026 |
Updated AWS SAM CLI support for building Rust functions to general availability | Building Rust functions with Cargo Lambda no longer requires opting in to beta features. Guidance for projects that contain multiple functions now uses a Cargo workspace. To learn more, see Building Rust Lambda functions with Cargo Lambda. | August 3, 2026 |
Added AWS SAM CLI support for Java 8, Java 11, and Java 17 on AL2023 |
| July 13, 2026 |
Added the AWS::Serverless::MicrovmImage and AWS::Serverless::NetworkConnector resource types | New reference sections describe how to create a Lambda MicroVM image from a code artifact stored in Amazon S3, and how to define network connectivity for Lambda compute resources. To learn more, see AWS::Serverless::MicrovmImage and AWS::Serverless::NetworkConnector. | July 6, 2026 |
Added --express option for the AWS SAM CLI sam deploy and sam sync commands | Use CloudFormation Express mode so that stack operations complete when resource configuration is applied, while resources continue becoming ready in the background. To learn more, see sam deploy and sam sync. | July 1, 2026 |
Added --no-watch option for the AWS SAM CLI sam local start-api and sam local start-lambda commands | Disable file watching when you use | June 10, 2026 |
Added AWS SAM CLI support for the AWS::LanguageExtensions transform | The AWS SAM CLI now expands | May 13, 2026 |
Added AWS SAM CLI support for Ruby 4.0 | Ruby 4.0 is now available as a runtime and image repository. See Image repositories and sam init. | April 27, 2026 |
Added the AWS::Serverless::WebSocketApi resource type | Define a WebSocket API with AWS SAM, including route, authorization, custom domain, and Route 53 configuration. To learn more, see AWS::Serverless::WebSocketApi. | April 13, 2026 |
Expanded the --invoke-image option for the AWS SAM CLI local commands | Specify | April 10, 2026 |
Added the SecurityPolicy and EndpointAccessMode properties for AWS::Serverless::Api | Set the TLS security policy and the endpoint access mode on a custom domain. To learn more, see DomainConfiguration. | April 10, 2026 |
Added the DockerImage build property for container image builds | Specify a custom name for the AWS SAM CLI-built Docker image. To learn more, see Building your application. | April 10, 2026 |
Added --container-dns option for the AWS SAM CLI local commands | Specify the DNS servers that local containers use. The option is available for sam local invoke, sam local start-api, and sam local start-lambda. | April 10, 2026 |
Added Amazon S3 Files file system support for AWS::Serverless::Function | Attach an Amazon S3 Files access point to a function with | April 8, 2026 |
Added AWS SAM CLI support for Docker BuildKit | Build container image functions with BuildKit. To learn more, see Using sam build. | March 10, 2026 |
Added .env file support for the --env-vars option | The | March 6, 2026 |
Added the IpAddressType property for AWS::Serverless::Api | Configure an API endpoint as | February 20, 2026 |
Added AWS SAM CLI support for the uv package manager | Build Python functions with uv. To learn more, see Building Python functions with uv. | February 19, 2026 |
Added the ResponseTransferMode property for events | Stream a function response through by setting | February 11, 2026 |
Added the LoggingConfig and MetricsConfig properties for Amazon MSK events | Configure event source mapping logging and enhanced metrics for an Amazon MSK event source. To learn more, see MSK. | February 2, 2026 |
Added the TenancyConfig property for AWS::Serverless::Function | Configure tenant isolation for a function, and pass a tenant with the new | November 20, 2025 |
Added the ProvisionedPollerConfig property for Amazon SQS events | Use provisioned mode for an Amazon SQS event source by setting a minimum and maximum number of pollers. To learn more, see SQS. | November 20, 2025 |
Added retry and batch properties for SelfManagedKafka events | The self-managed Kinesis event source now supports | November 20, 2025 |
Added AWS SAM CLI support for Node.js 24 | Node.js 24 is now available as a runtime and image repository. See Image repositories and sam init. | November 19, 2025 |
Added retry and batch properties for Amazon MSK events | The Amazon MSK event source now supports | November 19, 2025 |
Added the AWS::Serverless::CapacityProvider resource type | Run functions on Amazon Elastic Compute Cloud capacity that you own, and attach a capacity provider to a function with
| November 17, 2025 |
Added AWS SAM CLI support for Java 25 and Python 3.14 | Java 25 and Python 3.14 are now available as image repositories and | November 10, 2025 |
Added the Enabled property for Amazon MSK events | Pause and resume an Amazon MSK event source mapping. To learn more, see MSK. | October 16, 2025 |
Added build properties that preserve Python package structure | Specify | October 6, 2025 |
Added AWS SAM support for durable functions | Configure a durable function with the | September 25, 2025 |
Added AWS SAM CLI support for Finch | Use Finch instead of Docker to build with | August 19, 2025 |
Added the BatchSize property for Amazon MSK events | Set the maximum number of records that Lambda retrieves in a single batch from an Amazon MSK event source. To learn more, see MSK. | August 5, 2025 |
Added guidance for converting a Lambda console function to AWS SAM | Move a function you created in the Lambda console into an AWS SAM template so that you can manage it as infrastructure as code. To learn more, see Converting Lambda functions to AWS SAM applications. | August 5, 2025 |
Added the SchemaRegistryConfig property for Kinesis events | Use a schema registry with an Amazon MSK or self-managed Kinesis event source. To learn more, see MSK and SelfManagedKafka. | June 19, 2025 |
Added AWS SAM CLI support for .NET 9 | .NET 9 is now available as an image repository. See Image repositories. | June 4, 2025 |
Added AWS SAM support for custom domain names on private APIs | Attach a custom domain to a private REST API with the new | April 4, 2025 |
Added AWS SAM CLI support for Ruby 3.4 | Ruby 3.4 is now available as a runtime and image repository. See Image repositories and sam init. | March 24, 2025 |
Added --runtime option for the AWS SAM CLI sam local invoke command | Override the runtime defined in your template to test a function against a different runtime. To learn more, see sam local invoke. | March 11, 2025 |
Added --mount-symlinks and --no-memory-limit options for AWS SAM CLI commands | Mount top-level symlinks into the build container with | February 26, 2025 |
Added --no-use-container option for the AWS SAM CLI sam build and sam sync commands | Build your function on the local machine instead of inside a container. To learn more, see sam build and sam sync. | December 9, 2024 |
Added AWS SAM CLI support for Node.js 22 and Python 3.13 | Node.js 22 and Python 3.13 are now available as runtimes and image repositories. See Image repositories and sam init. | December 5, 2024 |
Added the PublishLambdaVersion property for AWS::Serverless::LayerVersion | Control whether AWS SAM publishes a new layer version. To learn more, see AWS::Serverless::LayerVersion. | December 5, 2024 |
Added the ProvisionedPollerConfig and MetricsConfig properties for event source mappings | Use provisioned mode for Amazon MSK and self-managed Kinesis event sources with | November 25, 2024 |
Added the SourceKMSKeyArn property for AWS::Serverless::Function | Specify the AWS KMS key that AWS SAM uses to encrypt your | November 14, 2024 |
Added the RecursiveLoop property for AWS::Serverless::Function | Set whether Lambda terminates or allows a recursive function invocation loop. To learn more, see AWS::Serverless::Function. | August 27, 2024 |
Added the KmsKeyArn property for event source mappings | Specify a AWS KMS key that encrypts your event source mapping filter criteria at rest. The property is available on the Amazon DocumentDB, DynamoDB, Kinesis, Amazon MQ, Amazon MSK, SelfManagedKafka, and Amazon SQS event sources. To learn more, see MSK. | August 21, 2024 |
Added the UseAliasAsEventTarget property for AWS::Serverless::StateMachine | Use the alias created by | August 12, 2024 |
Restructured and updated content throughout the developer guide | Reorganized and restructured the guide to improve discoverability and usability. Updated and improved titles. Provided additional details when introducting topics and concepts. | June 20, 2024 |
Added AWS SAM CLI support for for Ruby 3.3 | Ruby 3.3 is now available as a runtime and image repository. See Image repositories and sam init for details. | April 4, 2024 |
Added AWS SAM CLI command options | New options are available for the command
sam local start-api:
| March 20, 2024 |
Added AWS SAM CLI support for .NET 8 | .NET 8 is now available as a runtime and image repository. Run times and image repositories for .NET Core 3.1, Node.js 14, Node.js 12, Python 3.7, Ruby 2.7 are no longer supported. See Image repositories and sam init. | February 22, 2024 |
Added AWS SAM CLI arm64 package installer for Linux | For instructions, see Installing the AWS SAM CLI. | December 6, 2023 |
Added --watch-exclude option for the AWS SAM CLI sam sync command | Exclude files and folders from initiating a sync. To learn more, see Specify files and folders that won't initiate a sync. | December 6, 2023 |
Added --build-in-source option for the AWS SAM CLI sam sync command | Build your project in your source folder to speed up the build process. To learn more, see Speed up build times by building your project in the source folder. | December 6, 2023 |
Added --build-in-source option for the AWS SAM CLI sam build command | Build your project in your source folder to speed up the build process. To learn more, see Speed up build times by building your project in the source folder. | December 6, 2023 |
Added new resource support for AWS SAM CLI remote invoke command | Use | November 15, 2023 |
Added new AWS SAM CLI remote test-event command for shareable test events | Use the AWS SAM CLI to access and manage shareable test events from the EventBridge schema registry to test your Lambda functions in the AWS Cloud. To learn more, see Using sam remote test-event. | October 3, 2023 |
AWS SAM CLI support for Terraform is now generally available | To learn more about AWS SAM CLI support for Terraform, see AWS SAM CLITerraform support. | September 5, 2023 |
Added AWS SAM CLI support for Terraform Cloud | The AWS SAM CLI now supports local testing for Terraform Cloud. To learn more, see Set up for Terraform Cloud. | September 5, 2023 |
Added YAML file format support for the AWS SAM CLI configuration file | The AWS SAM CLI now supports the [ | July 18, 2023 |
Added AWS SAM CLI sam local start-api command support for Terraform | The What is AWS SAM CLI support for
Terraform? section has been updated to include AWS SAM CLI
| July 6, 2023 |
Added new AWS SAM CLI remote invoke command | To start using | June 22, 2023 |
Added AWS AppSync GraphQL API serverless resource type | Create new | June 22, 2023 |
Added AWS SAM CLI support for Ruby 3.2 | Update sam init page to include new base image and runtime values. Update Image repositories page with Ruby 3.2 Amazon ECR URI. | June 6, 2023 |
Added optional steps for integrity verification of the AWS SAM CLI package installer | Update Installing the AWS SAM CLI page to reflect optional step. Create Verify the integrity of the AWS SAM CLI installer page to document steps. | May 31, 2023 |
Added sam sync option to skip infrastructure sync | Customize whether an CloudFormation deployment is required each time | March 23, 2023 |
Added support for DocumentDB event source type | The AWS SAM template specification now supports | March 10, 2023 |
Build Rust Lambda functions with Cargo Lambda | Use the AWS SAM CLI to build your Rust Lambda functions using Cargo Lambda. To learn more, see Building Rust Lambda functions with Cargo Lambda. | February 23, 2023 |
Build function resources outside of AWS SAM | Added guidance on skipping functions when using the sam build command. To learn more, see Building functions outside of AWS SAM. | February 14, 2023 |
New embedded connectors syntax | Use the new embedded connectors syntax to define your
| February 8, 2023 |
Added new sam list command for the AWS SAM CLI | Use sam list to view important information about the resources in your serverless application. To learn more, see sam list. | February 2, 2023 |
Added Format and OutExtension build properties for esbuild | Building Node.js Lambda functions with esbuild now supports | February 2, 2023 |
Added runtime management options to the AWS SAM template specification | Configure runtime management options for your Lambda functions. To learn more, see
| January 24, 2023 |
Target property added to EventSource for AWS::Serverless::StateMachine resource. |
| January 13, 2023 |
Configure scaling of SQS pollers for Lambda functions | Configure scaling of SQS pollers with the | January 12, 2023 |
Validate AWS SAM applications with cfn-lint | You can use cfn-lint to validate your AWS SAM templates through the AWS SAM CLI. To learn more, see Validate with cfn-lint. | January 11, 2023 |
Monitor your serverless applications with CloudWatch Application Insights | Configure Amazon CloudWatch Application Insights to monitor your AWS SAM applications. To learn more, see Monitor your serverless applications with CloudWatch Application Insights. | December 19, 2022 |
Added AWS SAM CLI package installer for macOS | Install the AWS SAM CLI using the new macOS package installer. To learn more, see Installing the AWS SAM CLI. | December 6, 2022 |
Added support for Lambda SnapStart | Configure SnapStart for your Lambda functions to create snapshots, which are cached
states of your initialized functions. To learn more, see | November 28, 2022 |
Added AWS SAM CLI support for nodejs18.x | AWS SAM CLI now supports nodejs18.x runtime. To learn more, see sam init. | November 17, 2022 |
Added guidance on configuring access and permissions | AWS SAM provides two options that simplify management of access and permissions for your serverless applications.To learn more, see Managing resource access and permissions. | November 17, 2022 |
Added support for building .NET 7 Lambda functions with Native AOT compilation | Build and package your .NET 7 Lambda functions with AWS SAM, utilizing Native Ahead-of-Time (AOT) compilation to improve Lambda cold-start times. To learn more, see Building .NET 7 Lambda functions with Native AOT compilation. | November 15, 2022 |
Added AWS SAM CLI Terraform support for local debugging and testing | Use the AWS SAM CLI within your Terraform projects to perform local debugging and testing of your Lambda functions and layers. To learn more, see AWS SAM CLI Terraform support. | November 14, 2022 |
Added AWS SAM support for EventBridge Scheduler | The AWS Serverless Application Model (AWS SAM) template specification provides a simple, short-hand syntax that you can use to schedule events with EventBridge Scheduler for AWS Lambda and AWS Step Functions. For more information, see Scheduling events with EventBridge Scheduler. | November 10, 2022 |
Simplified the AWS SAM CLI installation instructions | AWS SAM CLI prerequisites and optional steps have been moved to separate pages. Installation steps for supported operating systems can be found at Installing the AWS SAM CLI. | November 4, 2022 |
Added fix to allow long paths for Windows 10 users | The AWS SAM CLI app templates repository contains some long file paths which may cause
errors when running | November 4, 2022 |
Updated gradual deployment process for first time deployments | Gradually deploying a Lambda function with AWS CodeDeploy requires two steps. To learn more, see Gradually deploying a Lambda function for the first time. | October 13, 2022 |
Additional Lambda event filtering support for more types of events |
| October 13, 2022 |
Added OpenID Connect (OIDC) support for AWS SAM pipeline | AWS SAM supports OpenID Connect (OIDC) user authentication for Bitbucket, GitHub Actions, and GitLab continuous integration and continuous delivery (CI/CD) platforms. To learn more, see Using OIDC User Accounts with AWS SAM pipeline. | October 13, 2022 |
Note on JwtConfiguration properties | Added note on defining | October 7, 2022 |
New properties for Function and StateMachine EventSource |
| October 6, 2022 |
AWS SAM connectors now generally available | Connectors are an AWS SAM abstract resource type, identified as
| October 6, 2022 |
Added new sam sync options to the AWS SAM CLI |
| September 20, 2022 |
Added new sam deploy options to the AWS SAM CLI |
| September 9, 2022 |
esbuild support now generally available | To build and package Node.js Lambda functions, you can use the AWS SAM CLI with the esbuild JavaScript bundler. | September 1, 2022 |
Updated AWS SAM CLI telemetry | Description of system and environment information collected has been updated to include hash values of usage attributes. | September 1, 2022 |
Added local environment variable support to AWS SAM CLI | Use environment variables with AWS SAM CLI when invoking Lambda functions locally and when running API Gateway locally. | September 1, 2022 |
Support for Lambda instruction set architectures | Use the AWS SAM CLI to build Lambda functions and Lambda layers for | October 1, 2021 |
Generating example pipeline configurations | Use the AWS SAM CLI to generate example pipelines for multiple CI/CD systems, using the
new | July 21, 2021 |
AWS SAM CLI AWS CDK integration (preview, phase 2) | With phase 2 of the public preview release, you can now use the AWS SAM CLI to package and deploy AWS CDK applications. You can also download a sample AWS CDK application directly using the AWS SAM CLI. For more information, see AWS Cloud Development Kit (AWS CDK) (Preview). | July 13, 2021 |
Support for RabbitMQ as an event source for functions | Added support for RabbitMQ as an event source for serverless functions. For more
information, see the | July 7, 2021 |
Deploying serverless applications using Amazon ECR build container images | Use Amazon ECR build container images to deploy serverless applications with common CI/CD systems such as AWS CodePipeline, Jenkins, GitLab CI/CD, and GitHub Actions. For more information, see Deploying serverless applications. | June 24, 2021 |
Debugging AWS SAM applications with AWS Toolkits | AWS Toolkits now supports step-through debugging with more combinations of integrated development environments (IDEs) and runtimes. For more information, see Using AWS Toolkits. | May 20, 2021 |
AWS SAM CLI AWS CDK integration (preview) | You can now use the AWS SAM CLI to locally test and build AWS CDK applications. This is a public preview release. For more information, see AWS Cloud Development Kit (AWS CDK) (Preview). | April 29, 2021 |
Default container image repository changed to Amazon ECR Public | The default container image repository changed from DockerHub to Amazon ECR Public. For more information, see Image repositories. | April 6, 2021 |
Nightly AWS SAM CLI builds | You can now install a pre-release version of the AWS SAM CLI, which is built nightly. For more information, see the Nightly build section of the OS subtopic of your choice under Installing the AWS SAM CLI. | March 25, 2021 |
Build container environment variables support | You can now pass environment variables to build containers. For more information, see
the | March 4, 2021 |
New Linux installation process | You can now install the AWS SAM CLI using a native Linux installer. For more information, see Installing the AWS SAM CLI on Linux. | February 10, 2021 |
Support for dead-letter queues for EventBridge | Added support for dead-letter queues for EventBridge and | January 29, 2021 |
Support for custom checkpoints | Added support for custom checkpoints for DynamoDB and Kinesis event sources for serverless
functions. For more information, see the | January 29, 2021 |
Support for tumbling windows | Added support for tumbling windows for DynamoDB and Kinesis event sources for serverless
functions. For more information, see the | December 17, 2020 |
Support for warm containers | Added support for warm containers when testing locally using the AWS SAM CLI commands
| December 16, 2020 |
Support for Lambda container images | Added support for Lambda container images. For more information, see Building applications. | December 1, 2020 |
Support for code signing | Added support for code signing and trusted deployments of serverless application code. For more information, see Configuring code signing for AWS SAM applications. | November 23, 2020 |
Support for parallel and cached builds | Improved performance of serverless application builds by adding two options to the
| November 10, 2020 |
Support for Amazon MQ, and mutual TLS authentication | Added support for Amazon MQ as an event source for serverless functions. For more
information, see the | November 5, 2020 |
Support for Lambda authorizers for HTTP APIs | Added support for Lambda authorizers for the | October 27, 2020 |
Support for multiple configuration files and environments | Added support for multiple configuration files and environments to store default parameter values for AWS SAM CLI commands. For more information, see AWS SAM CLI configuration file. | September 24, 2020 |
Support for X-Ray with Step Functions, and references when controlling access to APIs | Added support for X-Ray as an event source for serverless state machines. For more
information, see the | September 17, 2020 |
Support for Amazon MSK | Added support for Amazon MSK as an event source for serverless functions. This allows
records in an Amazon MSK topic to trigger your Lambda function. For more information, see the
| August 13, 2020 |
Support for Amazon EFS | Added support for mounting Amazon EFS file systems to local directories. This allows your
Lambda function code to access and modify shared resources. For more information, see the
| June 16, 2020 |
Orchestrating serverless applications | Added support for orchestrating applications by creating Step Functions state machines using
AWS SAM. For more information, see Orchestrating AWS resources with AWS Step Functions and the | May 27, 2020 |
Building custom runtimes | Added the ability to build custom runtimes. For more information, see Building custom runtimes. | May 21, 2020 |
Building layers | Added the ability to build individual | May 19, 2020 |
Generated CloudFormation resources | Provided details about the CloudFormation resources that AWS SAM generates and how to reference them. For more information, see Generated CloudFormation resources. | April 8, 2020 |
Setting up AWS credentials | Added instructions for setting up AWS credentials in case you haven't already set them to use with other AWS tools, such as one of the AWS SDKs or the AWS CLI. For more information, see Setting up AWS credentials. | January 17, 2020 |
AWS SAM specification and AWS SAM CLI updates | Migrated the AWS SAM specification from GitHub. For more information, see AWS SAM
specification. Also updated the deployment workflow with changes to the | November 25, 2019 |
New options for controlling access to API Gateway APIs and policy template updates | Added new options for controlling access to API Gateway APIs: IAM permissions, API keys, and resource policies. For more information, see Controlling access to API Gateway APIs. Also updated two policy templates: RekognitionFacesPolicy and ElasticsearchHttpPostPolicy. For more information, see AWS SAM policy templates. | August 29, 2019 |
Getting started updates | Updated the getting started chapter with improved installation instructions for the AWS SAM CLI and the Hello World tutorial. For more information, see Getting started with AWS SAM. | July 25, 2019 |
Controlling access to API Gateway APIs | Added support for controlling access to API Gateway APIs. For more information, see Controlling access to API Gateway APIs. | March 21, 2019 |
Added sam publish to the AWS SAM CLI | The new | December 21, 2018 |
Nested applications and layers support | Added support for nested applications and layers. For more information, see Using nested applications and Working with layers. | November 29, 2018 |
Added sam build to the AWS SAM CLI | The new | November 19, 2018 |
Added new installation options for the AWS SAM CLI | Added Linuxbrew (Linux), MSI (Windows), and Homebrew (macOS) installation options for the AWS SAM CLI. For more information, see Installing the AWS SAM CLI. | November 7, 2018 |
New guide | This is the first release of the AWS Serverless Application Model Developer Guide. | October 17, 2018 |