runtime_management_configs
Creates, updates, deletes, gets or lists a runtime_management_configs resource.
Overview
| Name | runtime_management_configs |
| Type | Resource |
| Id | aws.lambda.runtime_management_configs |
Fields
The following fields are returned by SELECT queries:
- get_runtime_management_config
| Name | Datatype | Description |
|---|---|---|
function_arn | string | The 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_arn | string | The 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_on | string | The current runtime update mode of the function. (Auto, Manual, FunctionUpdate) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_runtime_management_config | select | function_name, region | Qualifier | 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. |
put_runtime_management_config | replace | function_name, region, UpdateRuntimeOn | Qualifier | Sets 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.
| Name | Datatype | Description |
|---|---|---|
function_name | string | The 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. |
region | string | AWS region (default: us-east-1) |
Qualifier | string | Specify 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
- get_runtime_management_config
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
- put_runtime_management_config
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;