クォータ

AWS Step Functions 特定の期間の API アクションの数や定義できるステートマシンの数など、特定のステートマシンパラメータのサイズにクォータを設定します。これらのクォータは、正しく設定されていないステートマシンによりシステムのすべてのリソースが消費されないようにするために設計されていますが、その多くはハードクォータではありません。

サービスクォータの引き上げをリクエストするには、次のいずれかを行います。

• https://console.aws.amazon.com/servicequotas/home で Service Quotas コンソールを使用します。Service Quotas コンソールを使用したクォータ引き上げのリクエストの詳細については、「Service Quotas ユーザーガイド」の「クォータ引き上げのリクエスト」を参照してください。

• AWS Management Console で提供されるリソースの割り当てを地域ごとに増やすことをリクエストするには、Support センターページを使用してください。 AWS Step Functions 詳細については、「AWS 全般のリファレンス」の「AWS の Service Quotas」を参照してください。

注記

ステートマシン実行の特定のステージまたはアクティビティの実行に長い時間がかかる場合は、タイムアウトイベントを発生させるようにステートマシンのタイムアウトを設定できます。

一般的なクォータ

クォータ

説明

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 リクエストあたりの合計データサイズで、リクエストヘッダーおよびその他すべての関連リクエストデータを含みます。	ハードクォータ
アカウントあたりの最大オープン実行数	各 AWS リージョンの各 AWS アカウント で 1,000,000 回の実行。これを超えると、ExecutionLimitExceeded エラーが発生します。これは Express Workflow には適用されません。	百万
オープンマップ実行の最大数 オープンマップ実行とは、開始されてはいるがまだ完了していないマップランのことです。スケジュールされたマップランは、開いているマップランの合計数がデフォルトのクォータである 1000 MapRunStartedを下回るまでイベントで待機します。	1,000 このクォータは分散マップ状態に適用されます。	ハードクォータ
マップ実行の最大 redrives。	1,000 このクォータは分散マップ状態に適用されます。	ハードクォータ

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

API に関連するクォータ TestState

次の表は API TestState で利用できるクォータの一覧です。

API 名	クォータ	引き上げ可能
TestState	1 秒あたりのトランザクション (TPS) は 1	ハードクォータ

その他のクォータ

これらのクォータはソフトクォータであり、引き上げることができます。

	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	同期 Express 実行 API コールは、既存のアカウント容量制限には影響しません。Step Functions は、オンデマンドで容量を提供し、持続的なワークロードを使って、自動的に拡張します。容量が利用可能になるまで、ワークロードの急増をスロットリングできます。 スロットリングが発生した場合は、しばらくしてからもう一度試してください。同期 Express ワークフローの詳細については、「同期および非同期 Express ワークフロー」を参照してください。
StopExecution	1,000	200	500	25
TagResource	200	1	200	1
UntagResource	200	1	200	1
UpdateStateMachine	100	1	100	1

ステートマシンの実行に関連するクォータ

次の表では、ステートマシンの実行に関連するクォータについて説明しています。ステートマシンの実行クォータは、実行履歴の保持時間のクォータを除き、変更できないハードクォータです。

Quota	規格	Express
最大実行時間	1 年。実行が最大 1 年を超えると、States.Timeoutエラーで失敗し、メトリクスが出力されます。ExecutionsTimedOut CloudWatch	5 分。実行が最大 5 分を超えて実行されると、States.Timeoutエラーで失敗し、メトリクスが出力されます。ExecutionsTimedOut CloudWatch
実行履歴の最大サイズ	1 つのステートマシンの実行履歴の 25,000 件のイベント。実行履歴がこのクォータに達すると実行は失敗します。これを回避するには、履歴のクォータに到達しないようにする を参照してください	無制限。
最大実行アイドル時間	1 年 (最大実行時間によって制限されます)	5 分 (最大実行時間によって制約される)
実行履歴の保持時間	実行が終了してから 90 日後。この期間後は、実行履歴の取得や表示はできません。Step Functions が保持するクローズした実行の数にはこれ以上のクォータはありません。 コンプライアンス、組織、または規制の要件を満たすために、クォータリクエストを送信することによって実行履歴の保持期間を 30 日に短縮できます。そのためには、を使用して新しいケースを作成してください。 AWS Support Center Console 保存期間を 30 日に短縮する変更は、リージョンのアカウントレベルで適用されます。	実行履歴を表示するには、Amazon CloudWatch Logs ロギングを設定する必要があります。詳細については、「CloudWatch Logs を使用したログ記録」を参照してください。
実行 redrivable 期間 Redrivable 期間とは、特定の標準ワークフロー実行を redrive することができる期間のことです。この期間は、ステートマシンが実行を完了した日から始まります。	14 日間。 このハードクォータは分散マップ状態に適用されます。	Redrive は現在、Express ワークフローではサポートされていません。

タスクの実行に関連するクォータ

次の表は、タスク実行に関連するクォータについて説明し、変更できないハードクォータです。

Quota	規格	Express
最大タスク実行時間	1 年 (最大実行時間によって制限されます)	5 分 (最大実行時間によって制約される)
Step Functions がキューにタスクを保持する最大時間	1 年 (最大実行時間によって制限されます)	5 分 (最大実行時間によって制約される)
Amazon リソースネーム (ARN) あたりのアクティビティポーラー最大数	ARN あたりに GetActivityTask を呼び出すポーラー数: 1,000 このクォータを超えるとこのエラーが表示されます。「アクティビティタスクで同時にポーリングするワーカーの最大数に達しました」	Express ワークフローには適用されません。
タスク、状態、実行の最大の入力または出力サイズ	UTF-8 でエンコードされた文字列としての 256 KB のデータ。このクォータは、タスクのスケジュール、状態の入力、または実行の開始時に、タスク (アクティビティ、Lambda 関数、または統合サービス)、状態または実行出力、入力データに影響します。	UTF-8 でエンコードされた文字列としての 256 KB のデータ。このクォータは、タスクのスケジュール、状態の入力、または実行の開始時に、タスク (アクティビティ、Lambda 関数、または統合サービス)、状態または実行出力、入力データに影響します。

バージョンとエイリアスに関連するクォータ

リソース	デフォルトのクォータ
公開されているステートマシンバージョンの最大数	ステートマシンあたり 1000。 このソフトリミットの引き上げをリクエストするには、AWS Management Console の [サポートセンター] ページを使用してください。
ステートマシンエイリアスの最大数	ステートマシンあたり 1000。 このソフトリミットの引き上げをリクエストするには、AWS Management Console の [サポートセンター] ページを使用してください。

タグ付けに関連する制限

Step Functions リソースにタグ付けの場合は、次の制限に注意してください。

注記

タグ付けの制限は、他のクォータと違って増やすことはできません。

制限	説明
リソースあたりのタグの最大数	50
キーの最大長	UTF-8 で 128 文字の Unicode 文字
値の最大長	UTF-8 で 256 文字の Unicode 文字
プレフィックスの制限	aws:プレフィックスは使用専用なので、 AWS タグ名や値には使用しないでください。このプレフィックスが含まれるタグの名前または値は編集または削除できません。このプレフィックスの付いたタグは、リソースあたりのタグ数のクォータにカウントされません。
文字の制限	タグに使用できるのは、Unicode 文字、数字、空白、または _ . : / = + - @ のみです。