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: April 29, 2021
| Change | Description | Date |
|---|---|---|
| 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 --container-env-var and --container-env-var-file options in https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-cli-command-reference-sam-build.html. |
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 Schedule event sources for serverless functions and state machines. For more information, see the DeadLetterConfig property of the EventBridgeRule and Schedule event sources, for both the https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-function.html and https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-statemachine.html resource types. |
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 FunctionResponseTypes property of the https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-property-function-kinesis.html and https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-property-function-dynamodb.html data types of the https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-function.html resource type. |
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 TumblingWindowInSeconds property of the https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-property-function-kinesis.html and https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-property-function-dynamodb.html data types of the https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-function.html resource type. |
December 17, 2020 |
| Support for warm containers | Added support for warm containers when testing locally using the AWS SAM CLI commands https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-cli-command-reference-sam-local-start-api.html and https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-cli-command-reference-sam-local-start-lambda.html. For more information, see the --warm-containers option for those 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 https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-cli-command-reference-sam-build.html command: --parallel, which builds functions and layers in parallel rather than sequentially, and --cached, which uses build artifacts from previous builds when no changes have been made that requires a rebuild. |
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 https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-property-function-eventsource.html and https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-property-function-mq.html data types of the https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-function.html resource type. Also added support for mutual Transport Layer Security (TLS) authentication for API Gateway APIs and HTTP APIs. For more information, see the https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-property-api-domainconfiguration.html data type of the https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-api.html resource type, or the https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-property-httpapi-httpapidomainconfiguration.html data type of the https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-httpapi.html resource type. | November 5, 2020 |
| Support for Lambda authorizers for HTTP APIs | Added support for Lambda authorizers for the AWS::Serverless::HttpApi resource type. For more information, see Lambda authorizer example (AWS::Serverless::HttpApi). |
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 https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-statemachine.html#sam-statemachine-tracing property of the https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-statemachine.html resource type. Also added support for references when controlling access to APIs. For more information, see the https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-property-api-resourcepolicystatement.html data type. | 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 https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-property-function-eventsource.html and https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-property-function-msk.html data types of the https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-function.html resource type. | 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 https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-function.html#sam-function-filesystemconfigs property of the https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-function.html resource type. | 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 https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-statemachine.html resource type. | 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 LayerVersion resources. For more information, see Building layers. |
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 https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-cli-command-reference-sam-deploy.html command. | 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 https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-cli-command-reference-sam-publish.html command in the AWS SAM CLI simplifies the process for publishing serverless applications in the AWS Serverless Application Repository. For more information, see Publishing serverless applications using the AWS SAM CLI. | 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 https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-cli-command-reference-sam-build.html command in the AWS SAM CLI simplifies the process for compiling serverless applications with dependencies so that you can locally test and deploy these applications. For more information, see Building applications. | 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 |