Persistence Coverage for AWS Services

Overview of the persistence coverage across the implemented AWS services

Persistence Coverage Overview

ServiceSupportedPersistence Test SuiteLimitations
AWS Account Management
ACM (AWS Certificate Manager)
AWS Private Certificate Authority (CA)✔️✔️
Amplify✔️✔️
API Gateway✔️✔️
AppConfig✔️
applicationautoscaling
AppSync
Athena
Auto Scaling
Backup✔️✔️
Batch✔️
CE (Cost Explorer API)
CloudFormation✔️Users need to be sure that the stacks are completely deployed before saving LocalStack state. Users with complex inter-stack relationships may experience issues. Furthermore, we cannot guarantee that all the created services will be correctly restored.
CloudFront✔️✔️
CloudTrail✔️✔️
CloudWatch✔️✔️
CodeCommit✔️✔️
Cognito Identity✔️✔️
Cognito IDP (Cognito User Pools API)✔️✔️
Config✔️✔️
DMS (Database Migration Service)
DocumentDB
DynamoDB✔️✔️
DynamoDB Streams
EC2 (Elastic Compute Cloud)✔️Instances (Docker containers) are not persisted. The mock VM manager fully support persistence.
ECR (Elastic Container Registry)✔️✔️
ECS (Elastic Container Service)
EFS (Elastic File System)
EKS (Elastic Kubernetes Service)
ElastiCache✔️✔️
Elastic Beanstalk
ELB (Elastic Load Balancer)
ELB v2 (Elastic Load Balancer v2)
EMR (Elastic MapReduce)
ES (OpenSearch, legacy Elasticsearch)
EventBridge
Kinesis Data Firehose
FIS (Fault Injection Simulator)
Glacier (S3 Glacier)✔️✔️
Glue
IAM (Identity and Access Management)✔️✔️
identitystore
IoT (Internet of Things)
IoT Data
IoT Analytics
IoT Wireless
MSK (Managed Streaming for Apache Kafka)✔️✔️The Kafka instances are restored. However, their content is not.
Kinesis✔️✔️
Kinesis Data Analytics API
Kinesis Data Analytics API v2
KMS (Key Management Service)✔️✔️
Lake Formation
Lambda✔️✔️Hot-reloading Lambdas need special configuration. Visit the “Share deployment configuration between different machines” section in the Hot Reloading documentation page.
CloudWatch Logs✔️✔️
managedblockchain
mediaconvert
Elemental MediaStore
MemoryDB for Redis
Amazon MQ
MWAA (Managed Workflows for Apache Airflow)
Neptune
OpenSearch
Organizations
pinpoint✔️✔️
Pipes (EventBridge Pipes)
QLDB (Quantum Ledger Database)
ram (Resource Access Manager)
RDS (Relational Database Service)✔️✔️MSSQL does not support persistence.
RDS data (Relational Database Service Data)
Redshift
Resource Groups
Resource Groups Tagging API
Route 53✔️✔️
Route 53 Resolver✔️
S3 (Simple Storage Service)✔️✔️
SageMaker
scheduler (EventBridge Scheduler)
Secrets Manager✔️✔️
Serverless Application Repository
Service Discovery (Cloud Map)
SES (Simple Email Service)✔️✔️
SES v2 (Simple Email Service v2)
SNS (Simple Notification Service)✔️✔️
SQS (Simple Queue Service)✔️✔️
SSM (Web Services Systems Manager)✔️✔️
sso-admin (IAM Identity Center (successor to Single Sign-On))
Step Functions
STS (Security Token Service)✔️✔️
Support API✔️✔️
SWF (Simple Workflow Service)
textract✔️✔️
timestream✔️✔️
Transcribe✔️✔️
Transfer
wafv2
X-Ray✔️

Terminology

  • Persistence Test Suite: tested by LocalStack’s internal persistence test suite. To test persistence, we use an approach similar to snapshot parity test: we first record API responses from LocalStack, we then reset and restore the snapshotted state, and finally verify that the same API responses matches with the initial ones.