Step Functions 服務配額 - AWS Step Functions

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Step Functions 服務配額

AWS Step Functions 提供狀態機器參數的預設服務配額,例如一段期間內API的動作數量,或您可以定義的狀態機器數量。配額旨在防止設定錯誤的狀態機器消耗系統的所有資源,雖然許多 沒有硬性限制。

若要請求提高服務配額,您可以執行下列其中一項作業:

注意

如果狀態機器執行或活動執行的某個特定階段耗時過長,您可設定狀態機器逾時來觸發逾時事件。

一般配額

狀態機器、執行和活動任務的名稱長度不得超過 80 個字元。這些名稱對於您的帳戶和 AWS 區域必須是唯一的,且不得包含下列任何項目:

  • 空格

  • 萬用字元 (? *)

  • 括號字元 (< > { } [ ])

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

  • 控制字元 (\\u0000 - \\u001f\\u007f - \\u009f)。

Step Functions 接受狀態機器、執行、活動和包含非ASCII字元標籤的名稱。由於這類字元不適用於 Amazon CloudWatch,因此建議您只使用ASCII字元,以便追蹤 指標 CloudWatch。

與帳戶相關的配額

資源 預設配額 可以提高
註冊狀態機器的數量上限 10,000 25,000

註冊活動的數量上限

10,000 15,000

狀態機器定義的大小上限

1 MB 硬配額
請求大小上限 每個請求 1 MB。這是每個 Step Functions API請求的總資料大小,包括請求標頭和所有其他相關聯的請求資料。 硬配額

每個帳戶的開放執行上限

每個 各 AWS 帳戶 1,000,000 個執行 AWS 區域。超過此限制會造成 ExecutionLimitExceeded 錯誤。這不適用於 Express Workflows。 數百萬

開啟的映射執行數目上限

1000

此配額適用於分散式映射狀態

開啟的 Map Run 是已啟動但尚未完成的 Map Run。Scheduled Map Runs 會在MapRunStarted事件中等待,直到開啟的 Map Runs 總數小於配額。

硬配額

上限 redrives Map Run 的 。

1000

此配額適用於分散式映射狀態

硬配額
平行 Map Run 子執行數目上限 10,000

硬配額

與HTTP任務相關的配額

HTTP 任務會使用權杖儲存貯體方案調節,以維護 Step Functions 服務頻寬。

資源 儲存貯體大小 每秒重新填滿速率
HTTP 任務 300 300
資源 預設配額
HTTP 任務持續時間 — 傳送HTTP請求和接收回應的時間 60 秒 (硬配額)

與狀態調節相關的配額

Step Functions 狀態轉換會使用權杖儲存貯體方案來調節,以維持服務頻寬。標準工作流程和快速工作流程具有不同的狀態轉換限流。標準工作流程配額是軟配額,可以增加。

注意

在 Amazon ExecutionThrottledStateTransition,服務指標上的調節會報告為 CloudWatch。如需詳細資訊,請參閱 ExecutionThrottled CloudWatch 指標

Standard Express
服務指標 儲存貯體大小 每秒重新填滿速率 儲存貯體大小 每秒重新填滿速率

StateTransition 美國東部 (維吉尼亞北部)、美國西部 (奧勒岡) 和歐洲 (愛爾蘭)

5,000 5,000

無限制

無限制

StateTransition所有其他區域

800 800

無限制

無限制

與API動作限流相關的配額

有些 Step Functions API動作會使用權杖儲存貯體方案來調節,以維持服務頻寬。以下是軟配額,可以增加。

注意

調節配額是每個帳戶、每個 AWS 區域。

AWS Step Functions 可能會隨時增加儲存貯體大小和重新填充速率。

Standard Express
API name 儲存貯體大小 每秒重新填滿速率 儲存貯體大小 每秒重新填滿速率
StartExecution美國東部 (維吉尼亞北部)、美國西部 (奧勒岡) 和歐洲 (愛爾蘭) 1,300 300 6,000 6,000
StartExecution所有其他區域 800 150 6,000 6,000

與 相關的配額 TestState API

API name 配額 可以提高
TestState 每秒 1 次交易 (TPS) 硬配額

其他配額

以下是軟配額,可以增加。

US East (N. Virginia), US West (Oregon), and Europe (Ireland) All other regions
API name 儲存貯體大小 每秒重新填滿速率 儲存貯體大小 每秒重新填滿速率
CreateActivity 100 1 100 1
CreateStateMachine 100 1 100 1
CreateStateMachineAlias 100 1 100 1
DeleteActivity 100 1 100 1
DeleteStateMachine 100 1 100 1
DeleteStateMachineAlias 100 1 100 1
DeleteStateMachineVersion 100 1 100 1
DescribeActivity 200 1 200 1
DescribeExecution 300 15 250 10
DescribeMapRun 200 1 200 1
DescribeStateMachine 200 20 200 20
DescribeStateMachineAlias 200 1 200 1
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
ListMapRuns 100 1 100 1
ListStateMachineAliases 100 1 100 1
ListStateMachines 100 5 100 5
ListStateMachineVersions 100 1 100 1
ListTagsForResource 100 1 100 1
PublishStateMachineVersion 100 1 100 1
RedriveExecution 1,300 300 800 150
SendTaskFailure 3,000 500 1,500 300
SendTaskHeartbeat 3,000 500 1,500 300
SendTaskSuccess 3,000 500 1,500 300
StartSyncExecution

同步 Express 執行API呼叫不會造成現有的帳戶容量限制。Step Functions 可隨需提供容量,並隨著持續的工作負載自動擴展。工作負載激增可能會受到調節,直到容量可用為止。

如果您遇到限流,請在一段時間後再試一次。如需 Synchronous Express 工作流程的詳細資訊,請參閱 步驟函數中的同步和非同步快速工作流

StopExecution 1,000 200 500 25
TagResource 200 1 200 1
UntagResource 200 1 200 1
UpdateMapRun 100 1 100 1
UpdateStateMachine 100 1 100 1
UpdateStateMachineAlias 100 1 100 1
ValidateStateMachineDefinition 100 1 100 1

狀態機器執行的相關配額

下表說明與狀態機器執行相關的配額。狀態機器執行配額是無法變更的硬性配額,但執行歷史記錄保留時間配額除外。

配額 標準 Express

執行時間上限

1 年。如果執行執行時間超過 1 年上限,則會States.Timeout發生錯誤並發出ExecutionsTimedOut CloudWatch 指標。

5 分鐘。如果執行執行時間超過 5 分鐘上限,則會失敗並States.Timeout發生錯誤並發出ExecutionsTimedOut CloudWatch 指標。

執行歷史記錄大小上限

單一狀態機器執行歷史記錄中 25,000 個事件。如果執行歷史記錄達到此配額,執行將會失敗。若要避免這種情況,請參閱開始新的執行,以避免達到 Step Functions 中的歷史記錄配額 無限制。

執行閒置時間上限

1 年

受最長執行時間限制。

5 分鐘

受最長執行時間限制。

執行歷史記錄保留時間

執行關閉後 90 天。在這個時間之後,您就不能再擷取或檢視執行歷史記錄。Step Functions 保留的已關閉執行數目沒有進一步配額。

若要符合合規、組織或法規要求,您可以透過傳送配額請求,將執行歷史記錄保留期間縮短為 30 天。若要這樣做,請使用 AWS Support Center Console 並建立新案例。

將保留期縮短為 30 天的變更適用於區域中的每個帳戶。

若要查看執行歷史記錄,必須設定 Amazon CloudWatch Logs 記錄。如需詳細資訊,請參閱使用 CloudWatch 日誌記錄 Step Functions 中的執行歷史記錄

執行 redrivable period

14 天

硬配額適用於分散式映射狀態

Redrivable 期間是指您可以 redrive 指定的標準工作流程執行。此期間從狀態機器完成其執行的那一天開始。

Redrive Express 工作流程不支援 。

與任務執行相關的配額

下表說明與任務執行相關的配額。這些都是無法變更的硬性配額

配額 標準 Express
任務執行時間上限 1 年 — 受最長執行時間限制。 5 分鐘 — 受最長執行時間限制。
Step Functions 將任務保留在佇列中的時間上限 1 年 — 受最長執行時間限制。 5 分鐘 — 受最長執行時間限制。
每個 Amazon Resource Name 的活動輪詢器上限 (ARN) 每個 ARN 1,000 個呼叫 GetActivityTask 的輪詢器。超過此配額會導致此錯誤:「已到達同時輪詢活動任務的工作者數量上限。」 不適用於快速工作流程。
任務、狀態或執行的最大輸入或輸出大小 256 KiB 的資料做為 UTF-8 編碼字串。此配額會影響任務 (活動、Lambda 函數或整合服務)、狀態或執行輸出,以及排程任務、進入狀態或開始執行時的輸入資料。 256 KiB 的資料做為 UTF-8 編碼字串。此配額會影響任務 (活動、Lambda 函數或整合服務)、狀態或執行輸出,以及排程任務、進入狀態或開始執行時的輸入資料。

與版本和別名相關的配額

資源 預設配額
已發佈狀態機器版本的數目上限 每個狀態機器 1000 個
狀態機器別名的數量上限 每個狀態機器 100 個

若要請求增加已發佈狀態機器版本和別名的軟性限制,請使用 中的支援中心頁面AWS Management Console

與標記相關的限制

下列標記限制無法修改或增加。

  • 字首限制 - 請勿在標籤名稱或值中使用字aws:首,因為它保留僅供 AWS 使用。您無法編輯或刪除具有aws:字首的標籤名稱或值。字aws:首為 的標籤不會計入每個資源配額的標籤。

  • 字元限制 — 標籤只能包含 Unicode 字母、數字、空格或下列符號: _ . : / = + - @

限制 描述
每個資源的標籤數上限 50
金鑰長度上限 UTF-8 中的 128 個 Unicode 字元
​數值長度上限 UTF-8 中的 256 個 Unicode 字元