PutFunctionConcurrency
関数の同時実行数の最大値を設定して、同時実行レベルの容量を予約します。
同時実行設定は、すべての公開バージョンと未公開バージョンを含む、関数全体に適用されます。同時実行を予約すると、指定された数のイベントを同時に処理できる容量が関数に確保され、そのレベルを超えるスケーリングができなくなります。GetFunctionを使用して、関数の現在の設定を表示します。
GetAccountSettingsを使用して、リージョンの同時実行制限を表示します。関数ごとの制限が設定されていない関数に対して、100 以上の同時実行が予約されていない限り、任意の数の関数に対する同時実行を予約できます。詳細については、「Lambda 関数のスケーリング」を参照してください。
リクエストの構文
PUT /2017-10-31/functions/FunctionName
/concurrency HTTP/1.1
Content-type: application/json
{
"ReservedConcurrentExecutions": number
}
URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- FunctionName
-
Lambda 関数の名前
名前の形式
-
関数名 –
my-function
。 -
関数 ARN –
arn:aws:lambda:us-west-2:123456789012:function:my-function
。 -
部分的な ARN –
123456789012:function:my-function
。
完全な ARN にのみ適用される長さの制限 関数名のみを指定する場合、64 文字の長さに制限されます。
長さの制限: 最小長は 1 です。最大長は 140 です。
Pattern:
(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?
必須: はい
-
リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
- ReservedConcurrentExecutions
-
関数用に予約する同時実行数。
タイプ: 整数
値の範囲: 最小値 は 0 です。
必須: はい
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"ReservedConcurrentExecutions": number
}
レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- ReservedConcurrentExecutions
-
この関数用に予約済同時実行数。詳細については、「Lambda 予約済み同時実行数の管理」を参照してください。
型: 整数
有効な範囲: 最小値 は 0 です。
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- InvalidParameterValueException
-
リクエストに含まれているパラメータの 1 つが無効です。
HTTP ステータスコード:400
- ResourceConflictException
-
リソースが既に存在しているか、別のオペレーションが進行中です。
HTTP ステータスコード: 409
- ResourceNotFoundException
-
リクエストで指定されたリソースは存在しません。
HTTP ステータスコード: 404
- ServiceException
-
AWS Lambda サービスで内部エラーが発生しました。
HTTP ステータスコード: 500
- TooManyRequestsException
-
リクエストスループット制限を超えました。詳細については、「Lambda クォータ」を参照してください。
HTTP ステータスコード: 429
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。