Skip to main content

runtime_management_configs

Creates, updates, deletes, gets or lists a runtime_management_configs resource.

Overview

Nameruntime_management_configs
TypeResource
Idaws.lambda.runtime_management_configs

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
function_arnstringThe Amazon Resource Name (ARN) of your function. (pattern: <code>arn:(aws[a-zA-Z-]*)?:lambda:(eusc-)?[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-.]+(:($LATEST(.PUBLISHED)?|[a-zA-Z0-9-]+))?</code>)
runtime_version_arnstringThe ARN of the runtime the function is configured to use. If the runtime update mode is Manual, the ARN is returned, otherwise null is returned. (pattern: <code>arn:(aws[a-zA-Z-]*):lambda:(eusc-)?[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}::runtime:.+</code>)
update_runtime_onstringThe current runtime update mode of the function. (Auto, Manual, FunctionUpdate)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_runtime_management_configselectfunction_name, regionQualifierRetrieves the runtime management configuration for a function's version. If the runtime update mode is Manual, this includes the ARN of the runtime version and the runtime update mode. If the runtime update mode is Auto or Function update, this includes the runtime update mode and null is returned for the ARN. For more information, see Runtime updates.
put_runtime_management_configreplacefunction_name, region, UpdateRuntimeOnQualifierSets the runtime management configuration for a function's version. For more information, see Runtime updates.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
function_namestringThe name or ARN of the Lambda function. Name formats Function name – my-function. Function ARN – arn:aws:lambda:us-west-2:123456789012:function:my-function. Partial ARN – 123456789012:function:my-function. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.
regionstringAWS region (default: us-east-1)
QualifierstringSpecify a version of the function. This can be $LATEST or a published version number. If no value is specified, the configuration for the $LATEST version is returned.

SELECT examples

Retrieves the runtime management configuration for a function's version. If the runtime update mode is Manual, this includes the ARN of the runtime version and the runtime update mode. If the runtime update mode is Auto or Function update, this includes the runtime update mode and null is returned for the ARN. For more information, see Runtime updates.

SELECT
function_arn,
runtime_version_arn,
update_runtime_on
FROM aws.lambda.runtime_management_configs
WHERE function_name = '{{ function_name }}' -- required
AND region = '{{ region }}' -- required
AND Qualifier = '{{ Qualifier }}'
;

REPLACE examples

Sets the runtime management configuration for a function's version. For more information, see Runtime updates.

REPLACE aws.lambda.runtime_management_configs
SET
UpdateRuntimeOn = '{{ UpdateRuntimeOn }}',
RuntimeVersionArn = '{{ RuntimeVersionArn }}'
WHERE
function_name = '{{ function_name }}' --required
AND region = '{{ region }}' --required
AND UpdateRuntimeOn = '{{ UpdateRuntimeOn }}' --required
AND Qualifier = '{{ Qualifier}}'
RETURNING
function_arn,
runtime_version_arn,
update_runtime_on;