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。 -
関数 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-_]+))?必須: はい
-
- 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 を使用する方法の詳細については、以下を参照してください。
