Step Functions service quotas
AWS Step Functions provide default service quotas for state machine parameters, such as the number of API actions during a time period or the number of state machines that you can define. Quotas are designed to prevent misconfigured state machine from consuming all of the resources of the system, although many do not have hard limits.
To request a service quota increase, you can do one of the following:
-
Use the Service Quotas console at https://console.aws.amazon.com/servicequotas/home
. For information about requesting a quota increase using the Service Quotas console, see Requesting a quota increase in the Service Quotas User Guide. -
Use the Support Center page in the AWS Management Console to request a quota increase for resources provided by AWS Step Functions on a per-Region basis. For more information, see AWS service quotas in the AWS General Reference.
Important
New AWS accounts have reduced state transition quotas. AWS raises these quotas automatically based on your usage.
Note
If a particular stage of your state machine execution or activity execution takes too long, you can configure a state machine timeout to cause a timeout event.
Topics
General quotas
Names of state machines, executions, and activity tasks must not exceed 80 characters in length. These names must be unique for your account and AWS Region, and must not contain any of the following:
-
Whitespace
-
Wildcard characters (
? *) -
Bracket characters (
< > { } [ ]) -
Special characters (
" # % \ ^ | ~ ` $ & , ; : /) -
Control characters (
\\u0000-\\u001for\\u007f-\\u009f).
Step Functions accepts names for state machines, executions, activities, and labels that contain non-ASCII characters. Because such characters will prevent Amazon CloudWatch from logging data, we recommend using only ASCII characters so you can track Step Functions metrics.
Quotas related to accounts
| Resource | Default quota | Can be increased to |
|---|---|---|
| Maximum number of registered state machines | 100,000 | 150,000 |
|
Maximum number of registered activities |
100,000 | 150,000 |
|
Maximum size of state machine definition |
1 MB | Hard quota |
| Maximum request size | 1 MB per request. This is the total data size per Step Functions API request, including the request header and all other associated request data. | Hard quota |
|
Maximum open executions per account |
1,000,000 executions for each AWS account
in each AWS Region. Exceeding this limit will cause an
ExecutionLimitExceeded error. This doesn't apply to Express
Workflows. |
Millions |
Maximum number of open Map Runs |
1000 This quota applies to Distributed Map state. An open Map Run has started, but hasn't yet completed. Backlogged Map Runs wait at the MapRunStarted event until the total number of open Map Runs is less than the quota. |
Hard quota |
Maximum redrives of a Map Run. |
1000 This quota applies to Distributed Map state. |
Hard quota |
| Maximum number of parallel child executions within a single Map Run |
10,000 Step Functions dispatches express executions at up to 1,000 TPS and standard executions at up to 100 TPS. |
Hard quota |
Quotas related to HTTP Task
HTTP Tasks are throttled using a token bucket scheme to maintain the Step Functions service bandwidth.
| Resource | Bucket size | Refill rate per second |
|---|---|---|
| HTTP Task | 300 | 300 |
| Resource | Default quota |
|---|---|
| HTTP Task duration — time to send an HTTP request and receive a response | 60 seconds (Hard quota) |
Quotas related to state throttling
Step Functions state transitions are throttled using a token bucket scheme to maintain service bandwidth. Standard Workflows and Express Workflows have different state transition throttling. Standard Workflows quotas are soft quotas and can be increased.
Note
Throttling on the StateTransition service metric is reported as
ExecutionThrottled in Amazon CloudWatch. For more information, see the ExecutionThrottled CloudWatch metric.
| Standard | Express | |||
|---|---|---|---|---|
| Service metric | Bucket size | Refill rate per second | Bucket size | Refill rate per second |
|
|
5,000 | 5,000 |
Unlimited |
Unlimited |
|
|
800 | 800 |
Unlimited |
Unlimited |
Quotas related to API action throttling
Some Step Functions API actions are throttled using a token bucket scheme to maintain service bandwidth. The following are soft quotas and can be increased.
Note
Throttling quotas are per account, per AWS Region.
AWS Step Functions may increase both the bucket size and refill rate at any time.
| Standard | Express | |||
|---|---|---|---|---|
| API name | Bucket size | Refill rate per second | Bucket size | Refill rate per second |