[ aws . lambda ]

put-provisioned-concurrency-config

Description

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

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  put-provisioned-concurrency-config
--function-name <value>
--qualifier <value>
--provisioned-concurrent-executions <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--function-name (string)

The name 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.

--qualifier (string)

The version number or alias name.

--provisioned-concurrent-executions (integer)

The amount of provisioned concurrency to allocate for the version or alias.

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Examples

To allocate provisioned concurrency

The following put-provisioned-concurrency-config example allocates 100 provisioned concurrency for the BLUE alias of the specified function.

aws lambda put-provisioned-concurrency-config \
    --function-name my-function \
    --qualifier BLUE \
    --provisioned-concurrent-executions 100

Output:

{
    "Requested ProvisionedConcurrentExecutions": 100,
    "Allocated ProvisionedConcurrentExecutions": 0,
    "Status": "IN_PROGRESS",
    "LastModified": "2019-11-21T19:32:12+0000"
}

Output

RequestedProvisionedConcurrentExecutions -> (integer)

The amount of provisioned concurrency requested.

AvailableProvisionedConcurrentExecutions -> (integer)

The amount of provisioned concurrency available.

AllocatedProvisionedConcurrentExecutions -> (integer)

The amount of provisioned concurrency allocated.

Status -> (string)

The status of the allocation process.

StatusReason -> (string)

For failed allocations, the reason that provisioned concurrency could not be allocated.

LastModified -> (string)

The date and time that a user last updated the configuration, in ISO 8601 format .