限额 - Amazon Step Functions
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

限额

Amazon Step Functions 对特定状态机参数的大小施加了配额,例如在特定时间段内可以执行的 API 操作数或您可以定义的状态机数。虽然这些配额旨在防止错误配置的状态机消耗系统的所有资源,但是其中的很多限制并不是硬配额。

要请求增加服务限额,您可以执行以下操作之一:

  • 访问 https://console.aws.amazon.com/servicequotas/,使用服务限额控制台。有关请求增加配额的信息,请参阅《服务限额用户指南》中的请求增加配额

  • 使用 Amazon Web Services Management Console中的支持中心页面,按区域申请增加 Amazon Step Functions 提供的资源配额。有关更多信息,请参阅 Amazon Web Services 一般参考 中的 Amazon 服务限额

注意

如果状态机执行或活动执行的特定阶段耗时太长,您可以配置状态机超时来引发超时事件。

常规配额

限额 描述

Step Functions 中的名称

状态机、执行和活动任务的名称长度不得超过 80 个字符。对于您的账户和 Amazon 区域,这些名称必须是唯一的,并且不得包含以下任何内容:

  • 空格

  • 通配符 (? *)

  • 方括号字符 (< > { } [ ])

  • 特殊字符 (: ; , \ | ^ ~ $ # % & ` ")

  • 控制字符(\\u0000 - \\u001f\\u007f - \\u009f

如果您的状态机是快速类型,则可以为状态机的多个执行提供相同的名称。即使多个执行的名称相同,Step Functions 也会为每个快速状态机执行生成唯一的执行 ARN。

Step Functions 允许您为状态机、执行、活动、速率控制和包含非 ASCII 字符的标签创建名称。这些非 ASCII 名称不适用于 Amazon CloudWatch。为确保您可以跟踪 CloudWatch 指标,请选择一个仅使用 ASCII 字符的名称。

与账户相关的配额

资源 默认限额 可以增加至
已注册状态机的最大数量 10000 25000

已注册活动的最大数量

10000

15000

最大请求大小

每个请求 1 MB。这是每个 Step Functions API 请求的总数据大小,包括请求标头以及所有其他关联的请求数据。

硬配额

每个账户打开的最大执行数

每个 Amazon Web Services 区域的每个 Amazon Web Services 账户 100 万次执行。超过此限制会导致 ExecutionLimitExceeded 错误。这不适用于快速工作流。

数百万

打开 Map Run 的最大数量

打开的 Map Run 是指已经开始但尚未完成的 Map Run。预定的 Map Run 会在 MapRunStarted 事件中等待,直到打开的 Map Run 总数少于默认的 1000 个配额。

1000

此配额适用于分布式 Map 状态

硬配额

Map Run redrives的最大值。

1000

此配额适用于分布式 Map 状态

硬配额

与 HTTP 任务相关的配额

HTTP 任务会使用令牌桶方案节流,以维护 Step Functions 服务带宽。下表列出了 HTTP 任务的桶大小和重填速率。

资源 存储桶大小 每秒的重填速率
HTTP 任务 300 300

下表列出了 HTTP 任务持续时间的配额。

资源 默认限额

HTTP 任务持续时间

HTTP 任务持续时间是指 HTTP 任务发送 HTTP 请求和收到响应所花费的时间。

60 秒

这是硬性限额,无法更改。

与状态限制相关的配额

Step Functions 状态转换使用令牌存储桶方案进行限制,以便维护服务带宽。标准工作流和快速工作流具有不同的状态转换限制。标准工作流程配额是软配额,可以提高。

注意

在 Amazon CloudWatch 中,StateTransition 服务指标的限制将报告为 ExecutionThrottled。有关更多信息,请参阅 ExecutionThrottled CloudWatch 指标

Standard Express
服务指标 存储桶大小 每秒的重填速率 存储桶大小 每秒的重填速率

StateTransition美国东部(弗吉尼亚州北部)、美国西部(俄勒冈州)、欧洲地区(爱尔兰)

5000

5000

无限制

无限制

StateTransition所有其他区域

800

800

无限制

无限制

与 API 操作限制相关的配额

一些 Step Functions API 操作会使用令牌存储桶方案进行限制,以便维护服务带宽。这些配额是软配额,可以提高。

注意

限制配额针对每个账户和每个 Amazon 区域。Amazon Step Functions 随时可能增加存储桶大小和重填速率。

Standard Express
API 名称 存储桶大小 每秒的重填速率 存储桶大小 每秒的重填速率
StartExecution美国东部(弗吉尼亚州北部)、美国西部(俄勒冈州)、欧洲地区(爱尔兰) 1,300 300 6,000 6,000
StartExecution所有其他区域 800 150 6,000 6,000

与 TestState API 相关的配额

下表列出了 TestState API 的可用配额。

API 名称 限额 可以增加至
TestState 每秒 1 个事务 (TPS) 硬配额

其他配额

这些配额是软配额,可以提高。

In US East (N. Virginia), US West (Oregon), and Europe (Ireland) All other regions
API 名称 存储桶大小 每秒的重填速率 存储桶大小 每秒的重填速率
CreateActivity 100 1 100 1
CreateStateMachine 100 1 100 1
DeleteActivity 100 1 100 1
DeleteStateMachine 100 1 100 1
DescribeActivity 200 1 200 1
DescribeExecution 300 15 250 10
DescribeStateMachine 200 20 200 20
DescribeStateMachineForExecution 200 1 200 1
GetActivityTask 3,000 500 1,500 300
GetExecutionHistory 400 20 400 20
ListActivities 100 10 100 5
ListExecutions 200 5 100 2
ListStateMachines 100 5 100 5
ListTagsForResource 100 1 100 1
SendTaskFailure 3,000 500 1,500 300
SendTaskHeartbeat 3,000 500 1,500 300
SendTaskSuccess 3,000 500 1,500 300
StartSyncExecution

同步快速执行 API 调用不会影响现有的账户容量限制。Step Functions 按需提供容量,并根据持续的工作负载自动扩展。在容量扩展之前,可以限制工作负载激增。

如果您遇到限制,请稍后重试。有关同步快递工作流的信息,请参见同步和异步快速工作流

StopExecution 1,000 200 500 25
TagResource 200 1 200 1
UntagResource 200 1 200 1
UpdateStateMachine 100 1 100 1

与状态机执行相关的配额

下表描述了与状态机执行相关的配额。状态机执行配额是硬配额,不可更改,执行历史记录保留时间配额除外。

限额 Standard Express

最长执行时间

1 年。如果执行的运行时间超过 1 年的最长时间,它将失败并显示 States.Timeout 错误,同时发出 ExecutionsTimedOut CloudWatch 指标。

5 分钟。如果执行的运行时间超过 5 分钟的最长时间,它将失败并显示 States.Timeout 错误,同时发出 ExecutionsTimedOut CloudWatch 指标。

最大执行历史记录大小

单个状态机执行历史记录中有 25000 个事件。如果执行历史记录达到此配额,则执行将失败。要避免这种情况,请参阅避免达到历史记录的配额 无限制。

最长执行空闲时间

1 年(受最长执行时间限制)。

5 分钟(受最长执行时间限制)。

执行历史记录保留时间

执行结束后 90 天。此时间过后,无法再检索或查看执行历史。对 Step Functions 保留的已关闭执行数没有进一步的配额。

为了满足合规性、组织或监管要求,您可以通过发送配额请求,将执行历史记录的保留期缩短至 30 天。为实现该操作,请使用 Amazon Support Center Console并创建一个新案例。

将保留期缩短至 30 天的更改适用于区域中的每个账户。

要查看执行历史记录,必须配置 Amazon CloudWatch Logs 日志记录。有关更多信息,请参阅使用 CloudWatch Logs 进行日志记录

执行redrivable期

Redrivable期是指您可以redrive特定标准工作流执行的时间。这段时间从状态机完成执行的当天开始计算。

14 天。

此硬配额适用于分布式 Map 状态

Redrive目前不支持快速工作流。

与任务执行相关的配额

下表描述了与任务执行相关的配额,这些配额是无法更改的硬配额。

限额 Standard Express

最长任务执行时间

1 年(受最长执行时间限制)

5 分钟(受最长执行时间限制)

Step Functions 将任务保留在队列中的最长时间

1 年(受最长执行时间限制)

5 分钟(受最长执行时间限制)

每个 Amazon 资源名称 (ARN) 的最大活动轮询器数

每 ARN 1000 个调用 GetActivityTask 的轮询器。超出此配额将导致以下错误:“The maximum number of workers concurrently polling for activity tasks has been reached (已达到并发轮询活动任务的最大工作线程数目)。”

不适用于快速工作流。

任务、状态或执行的最大输入或输出大小

256 KB 数据,UTF-8 编码字符串。此配额影响计划任务、进入状态或启动执行时的任务(活动、Lambda 函数或集成服务)、状态或执行输出以及输入数据。

256 KB 数据,UTF-8 编码字符串。此配额影响计划任务、进入状态或启动执行时的任务(活动、Lambda 函数或集成服务)、状态或执行输出以及输入数据。

与版本与别名功能相关的配额

资源 默认限额
已发布状态机版本的最大数量

每个状态机 1000 个。

要请求提高此软限制,请使用 Amazon Web Services Management Console中的支持中心页面。

最大状态机别名数

每个状态机 100 个。

要请求提高此软限制,请使用 Amazon Web Services Management Console中的支持中心页面。

与标记相关的限制

在标记 Step Functions 资源时,请注意以下限制。

注意

标记限制不能像其他配额一样提高。

限制 描述

每个资源的最大标签数

50

最大密钥长度

128 个 Unicode 字符(采用 UTF-8 格式)

最大值长度

256 个 Unicode 字符(采用 UTF-8 格式)

前缀限制

请勿在标签名称或值中使用 aws: 前缀,因为它专为 Amazon 使用预留。您无法编辑或删除带此前缀的标签名称或值。具有此前缀的标签不计入每个资源的标签数配额。

字符限制

标签只能包含 Unicode 字母、数字、空格或以下符号:_ . : / = + - @