This document lists the quotas and system limits that apply to Workflows. Quotas specify the amount of a countable, shared resource that you can use, and they are defined by Google Cloud services such as Workflows. System limits are fixed values that cannot be changed.
Google Cloud uses quotas to help ensure fairness and reduce spikes in resource use and availability. A quota restricts how much of a Google Cloud resource your Google Cloud project can use. Quotas apply to a range of resource types, including hardware, software, and network components. For example, quotas can restrict the number of API calls to a service, the number of load balancers used concurrently by your project, or the number of projects that you can create. Quotas protect the community of Google Cloud users by preventing the overloading of services. Quotas also help you to manage your own Google Cloud resources.
The Cloud Quotas system does the following:
- Monitors your consumption of Google Cloud products and services
- Restricts your consumption of those resources
- Provides a way to request changes to the quota value
In most cases, when you attempt to consume more of a resource than its quota allows, the system blocks access to the resource, and the task that you're trying to perform fails.
Quotas generally apply at the Google Cloud project level. Your use of a resource in one project doesn't affect your available quota in another project. Within a Google Cloud project, quotas are shared across all applications and IP addresses.
There are also system limits on Workflows resources. System limits can't be changed.
Quotas
Workflows enforces the following quotas for each Google Cloud project. You can increase or decrease these quotas:
| Quota | Description | Value |
|---|---|---|
| Total workflows | The maximum number of workflows you can deploy per project | 10,000 |
| Concurrent executions | The maximum number of active workflow executions per region, per project. Concurrent executions are executions that have started and not yet completed or failed, including any that are waiting on callbacks or are sleeping. Once the quota is reached, and if
execution backlogging is enabled, executions are created in
a |
10,000 |
| Backlogged executions | The maximum number of backlogged workflow executions per region, per
project.
For more information, see Manage execution backlogging. |
100,000 |
| Workflow API requests | The maximum number of API requests (create,
update, list, get,
delete) from all workflows in your project
(per minute per location) |
1,200 |
| Execution API get requests | The maximum number of requests to get
workflow executions from all workflows in your project (per minute per
location) |
6,000 |
| Execution API list requests | The maximum number of requests to
list
workflow executions from all workflows in your project (per minute per
location) |
1,200 |
| Execution API write requests | The maximum number of requests to
create
and
cancel
workflow executions (including Eventarc-triggered
executions) from all workflows in your project (per minute per
location).
If Eventarc-triggered executions exceed this maximum, the events are retried following the Eventarc retry policy. |
6,000 |
| Execution API get step entries requests | The maximum number of requests to
get
a step entry from a workflow execution (per minute per location) |
6,000 |
| Execution API list step entries requests | The maximum number of requests to
list
step entries from a workflow execution (per minute per location) |
1,200 |
| Execution API export data requests | The maximum number of requests to
export data
from a workflow execution (per minute per location) |
10 |
| HTTP requests to callback endpoints | The maximum number of SendHttpCallback API requests made
on execution resources from all workflows in your project (per minute
per location) |
1,500 |
| Execution API list callback requests | The maximum number of requests to
list
callbacks from a workflow execution (per minute per location) |
300 |
Quota increase requests
To increase or decrease quotas, use the Google Cloud console. For more information, see Requesting a higher quota.
Step limits
Workflows enforces the following step limits for each workflow. You can't request changes to these limits:
| Limit | Description | Value |
|---|---|---|
| Assignments per step | The maximum number of assignments that may be performed in a single step | 50 |
| Conditions per switch | The maximum number of conditions that may be evaluated in a single switch block | 50 |
| Maximum call stack depth | The maximum number of levels of calling functions; for example, when a subworkflow calls itself or another subworkflow; or, standard library function calls that in turn call other functions | 20 |
| Minimum steps | The minimum number of steps within a workflow | 1 |
| Maximum steps | The maximum number of steps that may be performed in a single workflow execution | 100,000 |
Parallel step limits
Workflows enforces the following limits when using parallel steps. You can't request changes to these limits:
| Limit | Description | Value |
|---|---|---|
| Branches per step | The maximum number of branches supported within a parallel step | 10 |
| Parallel depth | The maximum depth that parallel steps can be nested | 2 |
| Concurrent branches and iterations | The maximum number of branches and iterations that can concurrently execute within a single workflow execution before further branches and iterations are automatically queued to wait for one or more running threads to complete. There is no total thread count limit; however, all other limits apply. |
20 |
| Uncaught exceptions within a parallel step | The maximum number of unhandled exceptions that can be raised during the execution of the workflow (in total) | 100 |
Resource limits
Workflows enforces the following usage limits. You can't request changes to these limits:
| Limit | Description | Value |
|---|---|---|
| Source code size | The maximum size of the YAML or JSON file that defines your workflow | 128 KB |
| Response size | The maximum size of an HTTP response (if saved to a variable, the memory limit for variables applies) | 2 MB |
| Expression length | The maximum number of characters in a single expression | 400 characters |
| Data size | The maximum cumulative size for variables, arguments, and events: | 512 KB |
|
||
|
||
|
||
| Maximum string length in bytes using UTF-8 encoding | 256 KB | |
| Environment variables | The maximum size for a
user-defined environment variable definition string
(KEY=value); a maximum of 20 variables can be defined |
4 KiB |
| Execution duration | The maximum duration (from start time to end time) for a workflow execution; any workflow that passes this limit ends with a time-out error | 1 year |
| Execution retention | The maximum retention period (after a workflow execution completes) of an execution's history and results | 90 days |
| Deduplication window | The deduplication window to ensure exactly-once processing when triggering a workflow execution with events | 24 hours |