PutProvisionedConcurrencyConfig - AWS Lambda

PutProvisionedConcurrencyConfig

プロビジョニングされた同時実行数の設定を関数のエイリアスまたはバージョンに追加します。

リクエストの構文

PUT /2019-09-30/functions/FunctionName/provisioned-concurrency?Qualifier=Qualifier HTTP/1.1 Content-type: application/json { "ProvisionedConcurrentExecutions": 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-_]+))?

必須: はい

Qualifier

バージョン番号またはエイリアス名。

長さの制限: 最小長は 1 です。最大長は 128 です。

パターン: (|[a-zA-Z0-9$_-]+)

必須: はい

リクエストボディ

リクエストは以下の JSON 形式のデータを受け入れます。

ProvisionedConcurrentExecutions

バージョンまたはエイリアスに割り当てるプロビジョニングされた同時実行数。

タイプ: 整数

値の範囲: 最小値 は 1 です。

必須: はい

レスポンスの構文

HTTP/1.1 202 Content-type: application/json { "AllocatedProvisionedConcurrentExecutions": number, "AvailableProvisionedConcurrentExecutions": number, "LastModified": "string", "RequestedProvisionedConcurrentExecutions": number, "Status": "string", "StatusReason": "string" }

レスポンス要素

アクションが成功すると、HTTP 202 レスポンスが返されます。

サービスから以下のデータが JSON 形式で返されます。

AllocatedProvisionedConcurrentExecutions

割り当てられたプロビジョニング済み同時実行数。線形デプロイと Canary デプロイ時に加重エイリアスを使用するとき、関数バージョンにプロビジョニングされる同時実行の量に応じて、この値は変動します。

型: 整数

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

AvailableProvisionedConcurrentExecutions

使用可能なプロビジョニング済み同時実行数。

タイプ: 整数

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

LastModified

ユーザーが最後に設定を更新した日時 (ISO 8601 形式)。

タイプ: 文字列

RequestedProvisionedConcurrentExecutions

リクエストされたプロビジョニング済み同時実行数。

タイプ: 整数

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

Status

割り当てプロセスのステータス

型: 文字列

有効な値: IN_PROGRESS | READY | FAILED

StatusReason

失敗した割り当ての、プロビジョニング済み同時実行を割り当てられなかった理由。

タイプ: 文字列

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

InvalidParameterValueException

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

HTTP ステータスコード:400

ResourceConflictException

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

HTTP ステータスコード: 409

ResourceNotFoundException

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

HTTP ステータスコード: 404

ServiceException

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

HTTP ステータスコード: 500

TooManyRequestsException

リクエストスループット制限を超えました。詳細については、「Lambda クォータ」を参照してください。

HTTP ステータスコード: 429

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

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