Understand CloudFormation quotas
Your AWS account has 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.
The following table shows the CloudFormation quotas.
Quotas |
Description |
Value |
Tuning strategy |
---|---|---|---|
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. |
|
Maximum amount of data that a custom resource provider can pass. |
4,096 bytes |
||
Dynamic references per template |
The maximum number of dynamic references allowed in a single CloudFormation stack template. For more informaiton, see General considerations. |
60 dynamic references in a stack template | |
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 | |
Maximum number of mappings that you can declare in your CloudFormation template. |
200 mappings |
To specify more mappings, separate your template into multiple templates by using, for example, nested stacks. |
|
Maximum number of mapping attributes for each mapping that you can declare in your CloudFormation template. |
200 attributes |
To specify more mapping attributes, separate the attributes into multiple mappings. |
|
Maximum size of each mapping name. |
255 characters |
||
Maximum number of modules you can register in the CloudFormation registry, per account and Region. |
100 modules |
||
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. For example, you can have a nested stack hierarchy with more than 2500 total resources, but you can't create, update, or delete more than 2500 of those resources in a single deployment. |
2500 resources | Split the stack hierarchy into different stacks. |
Maximum number of outputs that you can declare in your CloudFormation template. |
200 outputs |
||
Maximum size of an output name. |
255 characters |
||
Maximum number of parameters that you can declare in your CloudFormation template. |
200 parameters |
To specify more parameters, you can use mappings or lists in order to assign multiple values to a single parameter. |
|
Maximum size of a parameter name. |
255 characters |
||
Maximum size of a parameter value. |
4,096 bytes |
To use a larger parameterized value, create multiple parameters and then use Fn::Join to concatenate the multiple values into a single value. |
|
Maximum number of private resources that you can register in the CloudFormation registry per account and Region. |
50 private resources |
||
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. |
|
Maximum number of resources that you can declare in your CloudFormation template. |
500 resources |
To specify more resources, separate your template into multiple templates by using, for example, nested stacks. |
|
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. | ||
Maximum size of a resource name. |
255 characters |
||
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. |
|
Maximum size of Stack name. |
128 characters |
||
Maximum number of 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. |
|
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. |
|
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 |
|
Stacks imported using S3 object per stack set operation |
Maximum number of stacks you can import using S3 object per stack set operation. |
200 stacks |
|
Stacks imported using inline stack ids per stack set operation |
Maximum number of stacks you can import using inline stack IDs per stack set operation. |
10 stacks |
|
Maximum size of a template body that you can pass in a |
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. |
|
Maximum size of a template body that you can pass in an Amazon S3 object for a
|
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. |
|
Maximum size of a template description. |
1,024 bytes |
||
Versions per hook |
Maximum number of versions per hook. |
100 versions |
Feature availability
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)
-
-
Performing ECS blue/green deployments through CodeDeploy using CloudFormation is currently not available in the following Regions:
-
Africa (Cape Town)
-
Asia Pacific (Osaka)
-
Europe (Milan)
-
StackSets and macros
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 CloudFormation. For more information about macros, see Template macros.