Your AWS account has AWS CloudFormation quotas that you might need to know when authoring templates and creating stacks. By understanding these quotas, you can avoid limitation errors that would require you to redesign your templates or stacks.
AWS CloudFormation quotas
| Quotas | Description | Value | Tuning strategy |
|---|---|---|---|
| cfn-signal wait condition data | Maximum amount of data that cfn-signal can pass. | 4,096 bytes | To pass a larger amount, send the data to an Amazon S3 bucket, and then use cfn-signal to pass the Amazon S3 URL to that bucket. |
| Custom resource response | Maximum amount of data that a custom resource provider can pass. | 4,096 bytes | |
| Hooks per account | Maximum amount of hooks per account. | 100 hooks | |
| Hooks per resource | Maximum amount of hooks per resource. | 100 hooks | |
| Hooks configuration size | Maximum amount of data that a hook's configuration can store. | 204.8 KB | |
| Mappings | Maximum number of mappings that you can declare in your AWS CloudFormation template. | 200 mappings | To specify more mappings, separate your template into multiple templates by using, for example, nested stacks. |
| Mapping attributes | Maximum number of mapping attributes for each mapping that you can declare in your AWS CloudFormation template. | 200 attributes | To specify more mapping attributes, separate the attributes into multiple mappings. |
| Mapping name and mapping attribute name | Maximum size of each mapping name. | 255 characters | |
| Modules | Maximum number of modules you can register in the CloudFormation registry, per account and Region. | 100 modules | |
| Module versions | Maximum number of versions you can register in the CloudFormation registry for a given module. | 100 versions | To register new versions, first use DeregisterType to deregister versions you aren't using anymore. |
| Nested stacks | Maximum number of CloudFormation resources a nested stack can create, update, or delete per operation. | 2500 resources | Split the stack hierarchy into different stacks. |
| Outputs | Maximum number of outputs that you can declare in your AWS CloudFormation template. | 200 outputs | |
| Output name | Maximum size of an output name. | 255 characters | |
| Parameters | Maximum number of parameters that you can declare in your AWS CloudFormation template. | 200 parameters | To specify more parameters, you can use mappings or lists in order to assign multiple values to a single parameter. |
| Parameter name | Maximum size of a parameter name. | 255 characters | |
| Parameter value | Maximum size of a parameter value. | 4,096 bytes | To use a larger parameter value, create multiple parameters and then use Fn::Join to append the multiple values into a single value. |
| Private resources | Maximum number of private resources that you can register in the CloudFormation registry per account and Region. | 50 private resources | |
| Private resource versions | Maximum number of versions that you can register in the CloudFormation registry for a given private resource. | 50 private resources | To register new versions, first use DeregisterType to deregister versions you aren't using anymore. |
| Resources | Maximum number of resources that you can declare in your AWS CloudFormation template. | 500 resources | To specify more resources, separate your template into multiple templates by using, for example, nested stacks. |
| Resources in concurrent stack operations | Maximum number of resources you can have involved in stack operations (create, update, or delete operations) in your Region at a given time. | Use the DescribeAccountLimits API to determine the current limit for an account in a specific Region. | |
| Resource name | Maximum size of a resource name. | 255 characters | |
| Stacks | Maximum number of CloudFormation stacks that you can create. | 2000 stacks | To create more stacks, delete stacks that you don't need or request an increase in the maximum number of stacks in your AWS account. For more information, see AWS service quotas in the AWS General Reference. |
| Stack name | Maximum size of Stack name. | 128 characters | |
| StackSets | Maximum number of AWS CloudFormation stack sets you can create in your administrator account. | 1000 stack sets | To create more stack sets, delete stack sets that you don't need or request an increase in the maximum number of stack sets in your AWS account. For more information, see AWS service quotas in the AWS General Reference. |
| Stack instances | Maximum number of stack instances you can create per stack set. | 100,000 stack instances per stack set | To create more stack instances, delete stack instances that you don't need or request an increase in the maximum number of stack instances in your AWS account. For more information, see AWS service quotas in the AWS General Reference. |
| StackSets instance operations | Maximum number of stack instances, across all stack sets, that you can run operations on in each Region at the same time, per administrator account. | 10,000 operations | This limit applies across all stack sets involved in a Region. It includes stack instances affected by stack set creation and update operations, as well as creating, updating, or deleting stack instances directly. |
| StackSets queued operations | Maximum number of queued operations for a stack set at a given time. | 10,000 operations | |
| Template body size in a request | Maximum size of a template body that you can pass in a CreateStack, UpdateStack, or ValidateTemplate request. |
51,200 bytes | To use a larger template body, separate your template into multiple templates by using, for example, nested stacks. Or upload the template to an Amazon S3 bucket. |
| Template body size in an Amazon S3 object | Maximum size of a template body that you can pass in an Amazon S3 object for a CreateStack, UpdateStack, ValidateTemplate request with an Amazon S3 template URL. |
1 MB | To use a larger template body, separate your template into multiple templates by using, for example, nested stacks. Or use minification to reduce the CloudFormation template size. |
| Template description | Maximum size of a template description. | 1,024 bytes | |
| Versions per hook | Maximum number of versions per hook. | 100 versions |
Not all features of CloudFormation may be available in every Region. For more information about AWS Regions, see Global infrastructure Region table.
- Macros are currently not available in the following Region:
- Asia Pacific (Jakarta)
- Drift detection is currently not available in the following Region:
- Asia Pacific (Osaka)
- Performing ECS blue/green deployments through CodeDeploy using AWS CloudFormation is currently not available in the following Regions:
- Africa (Cape Town)
- Asia Pacific (Osaka)
- Europe (Milan)
StackSets does not currently support creating or updating stack sets with service-managed permissions from templates that contain macros. This includes transforms, which are macros hosted by AWS CloudFormation. For more information about macros, see Template macros.