配額 - AWS Step Functions

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

配額

AWS Step Functions 對某些狀態機參數的大小設置配額,例如特定時間段內的 API 動作數量或您可以定義的狀態機器數量。雖然這些配額的設計旨在預防設定錯誤的狀態機器使用系統的所有資源,但許多都不是硬性配額。

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

注意

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

一般配額

配額 描述

Step Functions 中的名稱

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

  • 空白

  • 萬用字元 (? *)

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

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

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

如果您的狀態機器的類型為 Express,則可以為狀態機器的多個執行提供相同的名稱。即使多個執行具有相同的名稱,Step Functions 也會為每個 Express 狀態機器執行產生唯一的執行 ARN。

Step Functions 可讓您建立狀態機器、執行項目和活動的名稱,以及包含非 ASCII 字元的標籤。這些非 ASCII 名稱不適用於 Amazon CloudWatch。若要確保您可以追蹤 CloudWatch 量度,請選擇僅使用 ASCII 字元的名稱。

與帳戶相關的配額

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

註冊活動的數量上限

10,000

15,000

請求大小上限

每個請求 1 MB。這是每個 Step Functions 數 API 請求的總數據大小,包括請求標頭和所有其他關聯的請求數據。

硬配額

每個帳戶的開放執行上限

每人每次執行 100 萬次 AWS 帳戶 。 AWS 區域超過這個配額將導致 ExecutionLimitExceeded 錯誤。這不適用於快速工作流程。

百萬

開啟地圖執行次數上限

開放的地圖運行是一個已經開始但尚未完成的地圖運行。排定的地圖執行會在MapRunStarted事件中等待,直到開啟的地圖執行總數少於預設配額 1000 為止。

1000

此配額適用於「分散式地圖」狀態

硬配額

地圖運行redrives的最大值。

1000

此配額適用於「分散式地圖」狀態

硬配額

與 HTTP 工作相關的配額

HTTP 任務使用令牌存儲桶方案進行限制,以維護Step Functions服務帶寬。下表列出 HTTP 工作的儲存貯體大小和重新填寫率。

資源 儲存貯體大小 每秒重新填滿速率
HTTP 任務 300 300

下表列出 HTTP 工作持續時間的配額。

資源 預設配額

HTTP 任務持續時間

HTTP 任務持續時間是指 HTTP 任務發送 HTTP 請求和接收響應所花費的時間。

60 秒

這是無法變更的硬配額。

與狀態節流有關的配額

Step Functions 狀態轉換使用令牌存儲桶方案進行限制,以維護服務帶寬。標準工作流程和 Express 工作流程具有不同的狀態轉換節流。標準工作流程配額是軟配額,可以增加。

注意

StateTransition服務指標的節流報告為 Amazon ExecutionThrottled 中。 CloudWatch如需詳細資訊,請參閱ExecutionThrottled CloudWatch 量度

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

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

5,000

5,000

無限制

無限制

StateTransition所有其他地區

800

800

無限制

無限制

與 API 動作節流相關的配額

某些 Step Functions API 操作使用令牌存儲桶方案進行限制,以維護服務帶寬。這些配額是軟配額,可以增加。

注意

節流配額是每個帳戶,每 AWS 個區域。 AWS 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

與狀態機器執行相關的配額

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

配額 標準 Express

執行時間上限

1 年。如果執行的時間超過 1 年的最大值,則會失敗並顯示States.Timeout錯誤並發出指標。ExecutionsTimedOut CloudWatch

5 分鐘。如果執行的執行時間超過 5 分鐘上限,則會失敗並顯示States.Timeout錯誤並發出ExecutionsTimedOut CloudWatch 測量結果。

執行歷史記錄大小上限

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

執行閒置時間上限

1 年 (受最長執行時間限制)。

5 分鐘(受最大執行時間的限制)。

執行記錄保留時間

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

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

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

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

執行redrivable期

Redrivable期間是指您可以redrive執行指定「標準工作流程」的時間。此期間從狀態機完成其執行之日開始。

十四天

此硬配額適用於「分散式地圖」狀態

Redrive快速工作流程目前不支援。

與工作執行相關的配額

下表說明與工作執行相關的配額,並且是無法變更的硬配額。

配額 標準 Express

任務執行時間上限

1 年 (受限於最大執行時間)

5 分鐘 (受限於最大執行時間)

最長時間 Step Functions 將工作保留在佇列中

1 年 (受限於最大執行時間)

5 分鐘 (受限於最大執行時間)

每個 Amazon 資源名稱 (ARN) 的最大活動輪詢器

每個 ARN 1,000 個呼叫 GetActivityTask 的輪詢器。超過此配額會導致此錯誤:「已到達同時輪詢活動任務的工作者數量上限。」

不適用於快速工作流程。

工作、狀態或執行項目的最大輸入或輸出大小

256 KB 的資料作為一個 UTF-8 編碼的字串。此配額會影響排程工作、進入狀態或開始執行時的工作 (活動、Lambda 函數或整合式服務)、狀態或執行輸出,以及輸入資料。

256 KB 的資料作為一個 UTF-8 編碼的字串。此配額會影響排程工作、進入狀態或開始執行時的工作 (活動、Lambda 函數或整合式服務)、狀態或執行輸出,以及輸入資料。

與版本和別名相關的配額

資源 預設配額
已發佈的狀態機版本數目上限

每個狀態機 1000 個。

若要要求提高此軟限制,請使用中的「Sup port 中心」頁面AWS Management Console

狀態機別名的最大數目

每個狀態機 100 個。

若要要求提高此軟限制,請使用中的「Sup port 中心」頁面AWS Management Console

與標記相關的限制

標記 Step Functions 資源時,請注意這些限制。

注意

標記限制無法像其他配額一樣增加。

限制 描述

每個資源的標籤數上限

50

金鑰長度上限

128 個 UTF-8 編碼的 Unicode 字元

​數值長度上限

256 個 UTF-8 編碼的 Unicode 字元

字首限制

請勿在標籤名稱或值中使用aws:前置詞,因為它已保留供 AWS 使用。您不可編輯或刪除具此字首的標籤名稱或值。具此字首的標籤,不會算在每個資源配額的標籤計數內。

字元限制

標籤只能包含 Unicode 字母、數字、空格或這些符號:_ . : / = + - @