PutFunctionConcurrency - AWS Lambda

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

  • 関数 ARNarn:aws:lambda:us-west-2:123456789012:function:my-function

  • 部分的な ARN123456789012: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 を使用する方法の詳細については、以下を参照してください。