IAmazonLambda.PutFunctionConcurrency Method (PutFunctionConcurrencyRequest)

Sets the maximum number of simultaneous executions for a function, and reserves capacity for that concurrency level.

Concurrency settings apply to the function as a whole, including all published versions and the unpublished version. Reserving concurrency both ensures that your function has capacity to process the specified number of events simultaneously, and prevents it from scaling beyond that level. Use GetFunction to see the current setting for a function.

Use GetAccountSettings to see your Regional concurrency limit. You can reserve concurrency for as many functions as you like, as long as you leave at least 100 simultaneous executions unreserved for functions that aren't configured with a per-function limit. For more information, see Lambda function scaling.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to PutFunctionConcurrencyAsync.

Namespace: Amazon.Lambda
Assembly: AWSSDK.Lambda.dll
Version: 3.x.y.z

Syntax

public abstract PutFunctionConcurrencyResponse PutFunctionConcurrency(
         PutFunctionConcurrencyRequest request
)

Parameters

request: Type: Amazon.Lambda.Model.PutFunctionConcurrencyRequest

Container for the necessary parameters to execute the PutFunctionConcurrency service method.

Return Value

Type: PutFunctionConcurrencyResponse

The response from the PutFunctionConcurrency service method, as returned by Lambda.

Exceptions

Exception	Condition
InvalidParameterValueException	One of the parameters in the request is not valid.
ResourceConflictException	The resource already exists, or another operation is in progress.
ResourceNotFoundException	The resource specified in the request does not exist.
ServiceException	The Lambda service encountered an internal error.
TooManyRequestsException	The request throughput limit was exceeded. For more information, see Lambda quotas.

Examples

The following example configures 100 reserved concurrent executions for the my-function function.

To configure a reserved concurrency limit for a function


var response = client.PutFunctionConcurrency(new PutFunctionConcurrencyRequest 
{
    FunctionName = "my-function",
    ReservedConcurrentExecutions = 100
});

int reservedConcurrentExecutions = response.ReservedConcurrentExecutions;

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

IAmazonLambda.PutFunctionConcurrency (PutFunctionConcurrencyRequest)

Method