AWS Step Functions
開発者ガイド

制限

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

注記

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

一般的な制限事項

制限 説明

Step Functions での名前

ステートマシン、実行、およびアクティビティ名の長さは 1~80 文字で、アカウントと AWS リージョンに対して一意である必要があります。また、次の文字を含めることはできません。

  • 空白

  • ワイルドカード文字 (? *)

  • 括弧 (< > { } [ ])

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

  • 制御文字 (\\u0000 - \\u001f or \\u007f - \\u009f)

Step Functions では、ASCII 以外の文字を含むステートマシン、実行、およびアクティビティの名前を作成することができます。これらの ASCII 以外の文字は Amazon CloudWatch では使用できません。CloudWatch メトリクスを追跡できるようにするには、ASCII 文字のみを使用する名前を選択します。

アカウントに関連する制限

制限 説明

登録済みアクティビティの最大数

10,000

登録済みステートマシンの最大数 10,000

API アクションの最大数

頻繁でないスパイクを超えてアプリケーションが非常に短期間に大量の API アクションを実行した場合、アプリケーションはスロットリングされることがあります。

最大リクエストサイズ

リクエストあたり 1 MB。これは Step Functions API リクエストあたりの合計データサイズで、リクエストヘッダーおよびその他すべての関連するリクエストデータを含みます。

アカウントあたりの最大オープン実行数

AWS アカウントあたり 1,000,000 回の実行。この制限を超えると、ExecutionLimitExceeded エラーが発生します。

ステートマシンの実行に関連する制限

制限 説明

最大実行時間

1 年.実行が 1 年の制限を超える場合、States.Timeout エラーで失敗し、ExecutionsTimedout CloudWatch メトリクスを出力します。

実行履歴の最大サイズ

25,000 イベント。実行履歴がこの制限に達すると実行は失敗します。これを回避するには、「履歴の上限に到達しないようにする」を参照してください。

最大実行アイドル時間

1 年 (実行時間の上限によって制限されます)

実行履歴の最大保持期間

90 日間.この期間後は、実行履歴の取得や表示はできません。Step Functions が保持するクローズした実行の数にはこれ以上の制限はありません。

タスクの実行に関連する制限

制限 説明

最大タスク実行時間

1 年 (実行時間の上限によって制限されます)

Step Functions がキューにタスクを保持する最大時間

1 年 (実行時間の上限によって制限されます)

Amazon リソースネーム (ARN) あたりの最大アクティビティポーラー

ARN あたりに GetActivityTask を呼び出すポーラー数: 1,000この制限を超えるとこのエラーが表示されます。「アクティビティタスクで同時にポーリングするワーカーの最大数に達しました」

タスク、状態、実行の最大の入力または結果データサイズ

32,768 文字.この制限により、タスクのスケジュール、状態の入力、または実行の開始時に、タスク (アクティビティまたは Lambda 関数)、状態、または実行結果データに影響があります。

API アクションのスロットリングに関連する制限

一部の Step Functions API アクションは、サービスの帯域幅を維持するため、トークンのバケットスキームを使用してスロットリングされます。

注記

スロットリング制限は 1 アカウント、AWS リージョンあたりです。AWS Step Functions によって、任意の時点でバケットサイズと補充レートの両方が上昇する可能性があります。コストを抑制するために、これらのスロットリングレートに依存しないでください。

米国東部(バージニア北部)、米国西部 (オレゴン)、および 欧州 (アイルランド)の制限

API 名 バケットサイズ 補充レート/秒
CreateActivity 100 1
CreateStateMachine 100 1
DeleteActivity 100 1
DeleteStateMachine 100 1
DescribeActivity 200 1
DescribeExecution 300 15
DescribeStateMachine 200 20
DescribeStateMachineForExecution 200 1
GetActivityTask 3,000 500
GetExecutionHistory 400 20
ListActivities 100 10
ListExecutions 200 5
ListStateMachines 100 5
ListTagsForResource 100 1
SendTaskFailure 3,000 500
SendTaskHeartbeat 3,000 500
SendTaskSuccess 3,000 500
StartExecution 1,300 300
StopExecution 1,000 200
TagResource 200 1
UntagResource 200 1
UpdateStateMachine 100 1

他のすべてのリージョンの制限

API 名 バケットサイズ 補充レート/秒
CreateActivity 100 1
CreateStateMachine 100 1
DeleteActivity 100 1
DeleteStateMachine 100 1
DescribeActivity 200 1
DescribeExecution 250 10
DescribeStateMachine 200 20
DescribeStateMachineForExecution 200 1
GetActivityTask 1,500 300
GetExecutionHistory 400 20
ListActivities 100 5
ListExecutions 100 2
ListStateMachines 100 5
ListTagsForResource 100 1
SendTaskFailure 1,500 300
SendTaskHeartbeat 1,500 300
SendTaskSuccess 1,500 300
StartExecution 800 150
StopExecution 500 25
TagResource 200 1
UntagResource 200 1
UpdateStateMachine 200 1

状態のスロットリングに関連する制限

Step Functions 状態の移行は、サービスの帯域幅を維持するため、トークンのバケットスキームを使用してスロットリングされます。

注記

StateTransition サービスメトリクスのスロットリングは、Amazon CloudWatch で ExecutionThrottled として報告されます。詳細については、「ExecutionThrottled CloudWatch メトリクス」を参照してください。

サービスメトリクス バケットサイズ 補充レート/秒

StateTransition米国東部(バージニア北部) では、米国西部 (オレゴン) および 欧州 (アイルランド)

5,000

1,500

StateTransitionその他のすべてのリージョン

800

500

タグ付けに関連する制限

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

注記

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

制限 説明

リソースあたりのタグの最大数

50

キーの最大長

UTF-8 で 128 文字の Unicode 文字

値の最大長

UTF-8 で 256 文字の Unicode 文字

プレフィックスの制限

タグの名前または値に aws: プレフィックスは使用しないでください。このプレフィックスは AWS 用に予約されています。このプレフィックスが含まれるタグの名前または値は編集または削除できません。このプレフィックスを持つタグは、リソースあたりのタグ数の制限時には計算されません。

文字の制限

タグに使用できるのは、Unicode 文字、数字、空白、または _ . : / = + - @ のみです。

制限の引き上げのリクエスト

AWS マネジメントコンソール の [サポートセンター] ページを使用して、リージョンごとに AWS Step Functions から提供されるリソースの制限の引き上げをリクエストします。詳細については、AWS General Referenceの「制限の拡大をリクエストするには」を参照してください。