クォータ - AWS Step Functions

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

クォータ

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

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

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

  • AWS Management Console の [Support Center] (サポートセンター) ページを使用して、リージョンごとに 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 には適用されません。

百万

オープンマップ実行の最大数

オープンマップ実行とは、開始されてはいるがまだ完了していないマップランのことです。スケジュールされたマップ実行は、MapRunStarted イベントが発生すると、オープンマップ実行の合計数がデフォルトのクォータである 1000 を下回るまで待機します。

1,000

このクォータは分散マップ状態に適用されます。

ハードクォータ

マップ実行の最大 redrives

1,000

このクォータは分散マップ状態に適用されます。

ハードクォータ

HTTP タスクに関連するクォータ

HTTP タスクは、Step Functions サービスの帯域幅を維持するため、トークンのバケットスキームを使用してスロットリングされます。次の表は、HTTP タスクのバケットサイズとリフィルレートを示しています。

[リソース] バケットサイズ 補充レート/秒
HTTP タスク 300 300

次の表に HTTP タスクの所要時間のクォータを示します。

[リソース] デフォルトのクォータ

HTTP タスクの所要時間

HTTP タスクの所要時間とは、HTTP タスクが HTTP リクエストを送信してレスポンスを受信するまでにかかる時間のことです。

60 秒

これはハードクォータであり、変更できません。

状態のスロットリングに関連するクォータ

Step Functions 状態の移行は、サービス帯域幅を維持するため、トークンのバケットスキームを使用してスロットリングされます。標準ワークフロー と Express ワークフローには、状態遷移スロットリングが異なります。標準ワークフロー はソフトクォータであり、引き上げることができます。

注記

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

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

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

5,000

5,000

無制限

無制限

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

800

800

無制限

無制限

API アクションのスロットリングに関連するクォータ

一部の Step Functions API アクションは、サービスの帯域幅を維持するため、トークンのバケットスキームを使用してスロットリングされます。これらのクォータはソフトクォータであり、引き上げることができます。

注記

スロットリングクォータは 1 アカウント、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) は 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

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

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

クォータ 規格 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 文字、数字、空白、または _ . : / = + - @ のみです。