provisioned_concurrency_configs

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

Overview

Name	provisioned_concurrency_configs
Type	Resource
Id	aws.lambda.provisioned_concurrency_configs

Fields

The following fields are returned by SELECT queries:

get_provisioned_concurrency_config

Name	Datatype	Description
allocated_provisioned_concurrent_executions	integer	The amount of provisioned concurrency allocated. When a weighted alias is used during linear and canary deployments, this value fluctuates depending on the amount of concurrency that is provisioned for the function versions.
available_provisioned_concurrent_executions	integer	The amount of provisioned concurrency available.
last_modified	string	The date and time that a user last updated the configuration, in ISO 8601 format. (pattern: <code>.*</code>)
requested_provisioned_concurrent_executions	integer	The amount of provisioned concurrency requested.
status	string	The status of the allocation process. (IN_PROGRESS, READY, FAILED)
status_reason	string	For failed allocations, the reason that provisioned concurrency could not be allocated.

list_provisioned_concurrency_configs

Name	Datatype	Description
allocated_provisioned_concurrent_executions	integer	The amount of provisioned concurrency allocated. When a weighted alias is used during linear and canary deployments, this value fluctuates depending on the amount of concurrency that is provisioned for the function versions.
available_provisioned_concurrent_executions	integer	The amount of provisioned concurrency available.
function_arn	string	The Amazon Resource Name (ARN) of the alias or version. (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|[a-zA-Z0-9-]+))?</code>)
last_modified	string	The date and time that a user last updated the configuration, in ISO 8601 format. (pattern: <code>.*</code>)
requested_provisioned_concurrent_executions	integer	The amount of provisioned concurrency requested.
status	string	The status of the allocation process. (IN_PROGRESS, READY, FAILED)
status_reason	string	For failed allocations, the reason that provisioned concurrency could not be allocated.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_provisioned_concurrency_config	select	function_name, Qualifier, region		Retrieves the provisioned concurrency configuration for a function's alias or version.
list_provisioned_concurrency_configs	select	function_name, region	Marker, MaxItems	Retrieves a list of provisioned concurrency configurations for a function.
put_provisioned_concurrency_config	replace	function_name, Qualifier, region, ProvisionedConcurrentExecutions		Adds a provisioned concurrency configuration to a function's alias or version.
delete_provisioned_concurrency_config	delete	function_name, Qualifier, region		Deletes the provisioned concurrency configuration for a function.

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
Qualifier	string	The version number or alias name.
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)
Marker	string	Specify the pagination token that's returned by a previous request to retrieve the next page of results.
MaxItems	integer	Specify a number to limit the number of configurations returned.

SELECT examples

get_provisioned_concurrency_config

Retrieves the provisioned concurrency configuration for a function's alias or version.

SELECT
allocated_provisioned_concurrent_executions,
available_provisioned_concurrent_executions,
last_modified,
requested_provisioned_concurrent_executions,
status,
status_reason
FROM aws.lambda.provisioned_concurrency_configs
WHERE function_name = '{{ function_name }}' -- required
AND Qualifier = '{{ Qualifier }}' -- required
AND region = '{{ region }}' -- required
;

list_provisioned_concurrency_configs

Retrieves a list of provisioned concurrency configurations for a function.

SELECT
allocated_provisioned_concurrent_executions,
available_provisioned_concurrent_executions,
function_arn,
last_modified,
requested_provisioned_concurrent_executions,
status,
status_reason
FROM aws.lambda.provisioned_concurrency_configs
WHERE function_name = '{{ function_name }}' -- required
AND region = '{{ region }}' -- required
AND Marker = '{{ Marker }}'
AND MaxItems = '{{ MaxItems }}'
;

REPLACE examples

put_provisioned_concurrency_config

Adds a provisioned concurrency configuration to a function's alias or version.

REPLACE aws.lambda.provisioned_concurrency_configs
SET 
ProvisionedConcurrentExecutions = {{ ProvisionedConcurrentExecutions }}
WHERE 
function_name = '{{ function_name }}' --required
AND Qualifier = '{{ Qualifier }}' --required
AND region = '{{ region }}' --required
AND ProvisionedConcurrentExecutions = '{{ ProvisionedConcurrentExecutions }}' --required
RETURNING
allocated_provisioned_concurrent_executions,
available_provisioned_concurrent_executions,
last_modified,
requested_provisioned_concurrent_executions,
status,
status_reason;

DELETE examples

delete_provisioned_concurrency_config

Deletes the provisioned concurrency configuration for a function.

DELETE FROM aws.lambda.provisioned_concurrency_configs
WHERE function_name = '{{ function_name }}' --required
AND Qualifier = '{{ Qualifier }}' --required
AND region = '{{ region }}' --required
;