Understand CloudFormation quotas - AWS CloudFormation

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

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

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

Mappings

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.

Mapping attributes

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.

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.

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.

Outputs

Maximum number of outputs that you can declare in your 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 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 parameterized value, create multiple parameters and then use Fn::Join to concatenate 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 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 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

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

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

Feature availability

Not all features of CloudFormation may be available in every Region. For more information about AWS Regions, see Global infrastructure Region table.

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.