Document history for Amazon SAM
The following table describes the important changes in each release of the Amazon 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 Amazon 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 Amazon SAM CLI command options | New options are available for the command
sam local start-api:
| March 20, 2024 |
Added Amazon 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 Amazon SAM CLI arm64 package installer for Linux | For instructions, see Installing the Amazon SAM CLI. | December 6, 2023 |
Added --watch-exclude option for the Amazon 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 Amazon 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 Amazon 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 Amazon SAM CLI remote invoke command | Use | November 15, 2023 |
Added new Amazon SAM CLI remote test-event command for shareable test events | Use the Amazon SAM CLI to access and manage shareable test events from the EventBridge schema registry to test your Lambda functions in the Amazon Web Services Cloud. To learn more, see Using sam remote test-event. | October 3, 2023 |
Amazon SAM CLI support for Terraform is now generally available | To learn more about Amazon SAM CLI support for Terraform, see Amazon SAM CLITerraform support. | September 5, 2023 |
Added Amazon SAM CLI support for Terraform Cloud | The Amazon 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 Amazon SAM CLI configuration file | The Amazon SAM CLI now supports the [ | July 18, 2023 |
Added Amazon SAM CLIsam local start-api command support for Terraform | The What is Amazon SAM CLI support for
Terraform? section has been updated to include Amazon SAM CLI
| July 6, 2023 |
Added new Amazon SAM CLI remote invoke command | To start using | June 22, 2023 |
Added Amazon AppSyncGraphQL API serverless resource type | Create new | June 22, 2023 |
Added Amazon 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 Amazon SAM CLI package installer | Update Installing the Amazon SAM CLI page to reflect optional step. Create Verify the integrity of the Amazon SAM CLI installer page to document steps. | May 31, 2023 |
Added sam sync option to skip infrastructure sync | Customize whether an Amazon CloudFormation deployment is required each time | March 23, 2023 |
Added support for DocumentDB event source type | The Amazon SAM template specification now supports | March 10, 2023 |
Build Rust Lambda functions with Cargo Lambda | Use the Amazon 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 Amazon SAM | Added guidance on skipping functions when using the sam build command. To learn more, see Building functions outside of Amazon 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 Amazon 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 Amazon 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 Amazon SAM applications with cfn-lint | You can use cfn-lint to validate your Amazon SAM templates through the Amazon 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 Amazon SAM applications. To learn more, see Monitor your serverless applications with CloudWatch Application Insights. | December 19, 2022 |
Added Amazon SAM CLI package installer for macOS | Install the Amazon SAM CLI using the new macOS package installer. To learn more, see Installing the Amazon 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 Amazon SAM CLI support for nodejs18.x | Amazon SAM CLI now supports nodejs18.x runtime. To learn more, see sam init. | November 17, 2022 |
Added guidance on configuring access and permissions | Amazon 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 Amazon 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 Amazon SAM CLITerraform support for local debugging and testing | Use the Amazon SAM CLI within your Terraform projects to perform local debugging and testing of your Lambda functions and layers. To learn more, see Amazon SAM CLI Terraform support. | November 14, 2022 |
Added Amazon SAM support for EventBridge Scheduler | The Amazon Serverless Application Model (Amazon SAM) template specification provides a simple, short-hand syntax that you can use to schedule events with EventBridge Scheduler for Amazon Lambda and Amazon Step Functions. For more information, see Scheduling events with EventBridge Scheduler. | November 10, 2022 |
Simplified the Amazon SAM CLI installation instructions | Amazon SAM CLI prerequisites and optional steps have been moved to separate pages. Installation steps for supported operating systems can be found at Installing the Amazon SAM CLI. | November 4, 2022 |
Added fix to allow long paths for Windows 10 users | The Amazon 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 Amazon 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 Amazon SAM pipeline | Amazon 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 Amazon 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 |
Amazon SAM connectors now generally available | Connectors are an Amazon SAM abstract resource type, identified as
| October 6, 2022 |
Added new sam sync options to the Amazon SAM CLI |
| September 20, 2022 |
Added new sam deploy options to the Amazon SAM CLI |
| September 9, 2022 |
esbuild support now generally available | To build and package Node.js Lambda functions, you can use the Amazon SAM CLI with the esbuild JavaScript bundler. | September 1, 2022 |
Updated Amazon 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 Amazon SAM CLI | Use environment variables with Amazon SAM CLI when invoking Lambda functions locally and when running API Gateway locally. | September 1, 2022 |
Support for Lambda instruction set architectures | Use the Amazon SAM CLI to build Lambda functions and Lambda layers for | October 1, 2021 |
Generating example pipeline configurations | Use the Amazon SAM CLI to generate example pipelines for multiple CI/CD systems, using the
new | July 21, 2021 |
Amazon SAM CLIAmazon CDK integration (preview, phase 2) | With phase 2 of the public preview release, you can now use the Amazon SAM CLI to package and deploy Amazon CDK applications. You can also download a sample Amazon CDK application directly using the Amazon SAM CLI. For more information, see Amazon Cloud Development Kit (Amazon 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 Amazon CodePipeline, Jenkins, GitLab CI/CD, and GitHub Actions. For more information, see Deploying serverless applications. | June 24, 2021 |
Debugging Amazon SAM applications with Amazon Toolkits | Amazon Toolkits now supports step-through debugging with more combinations of integrated development environments (IDEs) and runtimes. For more information, see Using Amazon Toolkits. | May 20, 2021 |
Amazon SAM CLIAmazon CDK integration (preview) | You can now use the Amazon SAM CLI to locally test and build Amazon CDK applications. This is a public preview release. For more information, see Amazon Cloud Development Kit (Amazon 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 Amazon SAM CLI builds | You can now install a pre-release version of the Amazon SAM CLI, which is built nightly. For more information, see the Nightly build section of the OS subtopic of your choice under Installing the Amazon 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 Amazon SAM CLI using a native Linux installer. For more information, see Installing the Amazon 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 Amazon 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 Amazon 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 Amazon SAM CLI commands. For more information, see Amazon 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
Amazon SAM. For more information, see Orchestrating Amazon resources with Amazon 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 Amazon CloudFormation resources | Provided details about the Amazon CloudFormation resources that Amazon SAM generates and how to reference them. For more information, see Generated Amazon CloudFormation resources. | April 8, 2020 |
Setting up Amazon credentials | Added instructions for setting up Amazon credentials in case you haven't already set them to use with other Amazon tools, such as one of the Amazon SDKs or the Amazon CLI. For more information, see Setting up Amazon credentials. | January 17, 2020 |
Amazon SAM specification and Amazon SAM CLI updates | Migrated the Amazon SAM specification from GitHub. For more information, see Amazon 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 Amazon SAM policy templates. | August 29, 2019 |
Getting started updates | Updated the getting started chapter with improved installation instructions for the Amazon SAM CLI and the Hello World tutorial. For more information, see Getting started with Amazon 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 Amazon 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 Amazon SAM CLI | The new | November 19, 2018 |
Added new installation options for the Amazon SAM CLI | Added Linuxbrew (Linux), MSI (Windows), and Homebrew (macOS) installation options for the Amazon SAM CLI. For more information, see Installing the Amazon SAM CLI. | November 7, 2018 |
New guide | This is the first release of the Amazon Serverless Application Model Developer Guide. | October 17, 2018 |