GetRuntimeManagementConfig
関数のバージョンに関するランタイム管理設定を取得します。ランタイム更新モードが手動の場合、これにはランタイムバージョンの ARN と、ランタイム更新モードが含まれます。ランタイム更新モードが自動または関数の更新の場合、これにはランタイム更新モードが含まれ、ARN には null
が返されます。詳細については、「ランタイム更新」を参照してください。
リクエストの構文
GET /2021-07-20/functions/FunctionName
/runtime-management-config?Qualifier=Qualifier
HTTP/1.1
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 です。最大長は 170 です。
パターン:
(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
-
関数のバージョンを指定します。これは、
$LATEST
または発行済みのバージョン番号にすることができます。値が指定されていない場合は、$LATEST
バージョンの設定が返されます。長さの制限:最小長は 1 です。最大長は 128 です。
Pattern:
(|[a-zA-Z0-9$_-]+)
リクエストボディ
リクエストにリクエスト本文がありません。
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"FunctionArn": "string",
"RuntimeVersionArn": "string",
"UpdateRuntimeOn": "string"
}
レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- FunctionArn
-
関数の Amazon リソースネーム (ARN)。
型: 文字列
パターン:
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-_]+))?
- RuntimeVersionArn
-
関数が使用するように設定されているランタイムのARN です。ランタイム更新モードが手動の場合は ARN が返され、それ以外の場合は
null
が返されます。型: 文字列
長さ制限: 最小長は 26 です。最大長は 2,048 です。
パターン:
^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$
- UpdateRuntimeOn
-
関数の現在のランタイム更新モードです。
型: 文字列
有効な値:
Auto | Manual | FunctionUpdate
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- InvalidParameterValueException
-
リクエストに含まれているパラメータの 1 つが無効です。
HTTP ステータスコード:400
- ResourceNotFoundException
-
リクエストで指定されたリソースは存在しません。
HTTP ステータスコード: 404
- ServiceException
-
AWS Lambda サービスで内部エラーが発生しました。
HTTP ステータスコード: 500
- TooManyRequestsException
-
リクエストスループット制限を超えました。詳細については、「Lambda クォータ」を参照してください。
HTTP ステータスコード: 429
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。