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: June 20, 2024
| Change | Description | Date |
|---|---|---|
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 CLIsam 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 AppSyncGraphQL 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 AWS 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 CLITerraform 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 CLIAWS 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 CLIAWS 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 AWS CloudFormation resources | Provided details about the AWS CloudFormation resources that AWS SAM generates and how to reference them. For more information, see Generated AWS 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 |
