PutFunctionConcurrency - AWS Lambda

PutFunctionConcurrency

関数の同時実行数の最大値を設定して、同時実行レベルの容量を予約します。

同時実行設定は、すべての公開バージョンと未公開バージョンを含む、関数全体に適用されます。同時実行を予約すると、指定された数のイベントを同時に処理できる容量が関数に確保され、そのレベルを超えるスケーリングができなくなります。GetFunctionを使用して、関数の現在の設定を表示します。

GetAccountSettingsを使用して、リージョンの同時実行制限を表示します。関数ごとの制限が設定されていない関数に対して、100 以上の同時実行が予約されていない限り、任意の数の関数に対する同時実行を予約できます。詳細については、「同時実行数の管理」を参照してください。

リクエストの構文

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

この関数用に予約済同時実行数。詳細については、「同時実行数の管理」を参照してください。

タイプ: 整数

有効な範囲: 最小値 は 0 です。

エラー

InvalidParameterValueException

リクエストに含まれているパラメータの 1 つが無効です。

HTTP ステータスコード: 400

ResourceConflictException

リソースが既に存在しているか、別のオペレーションが進行中です。

HTTP ステータスコード: 409

ResourceNotFoundException

リクエストで指定されたリソースは存在しません。

HTTP ステータスコード: 404

ServiceException

AWS Lambda サービスで内部エラーが発生しました。

HTTP ステータスコード: 500

TooManyRequestsException

リクエストスループット制限を超えました。

HTTP ステータスコード: 429

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、次を参照してください: