/2015-03-31/functions/{FunctionName}/configuration

The AWS Lambda multi-region endpoint

http://lambda.{region}.amazonaws.com

PUT

Modify the version-specific settings of a Lambda function.

When you update a function, Lambda provisions an instance of the function and its supporting resources. If your function connects to a VPC, this process can take a minute. During this time, you can't modify the function, but you can still invoke it. The LastUpdateStatus, LastUpdateStatusReason, and LastUpdateStatusReasonCode fields in the response from GetFunctionConfiguration indicate when the update is complete and the function is processing events with the new configuration. For more information, see Function States.

These settings can vary between versions of a function and are locked when you publish a version. You can't modify the configuration of a published version, only the unpublished version.

To configure function concurrency, use PutFunctionConcurrency. To grant invoke permissions to an account or Amazon Web Services service, use AddPermission.

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request PUT 'http://lambda.{region}.amazonaws.com/2015-03-31/functions//configuration' \
--header 'Content-Type: application/json' \
--data-raw '{
    "Role": "string",
    "Handler": "string",
    "Description": "string",
    "Timeout": 1,
    "MemorySize": 128,
    "VpcConfig": {
        "SubnetIds": [],
        "SecurityGroupIds": []
    },
    "Environment": {
        "Variables": {
            "property1": "pa$$word",
            "property2": "pa$$word"
        }
    },
    "Runtime": "nodejs",
    "DeadLetterConfig": {
        "TargetArn": "string"
    },
    "KMSKeyArn": "string",
    "TracingConfig": {
        "Mode": "Active"
    },
    "RevisionId": "string",
    "Layers": [
        "string"
    ],
    "FileSystemConfigs": [
        {
            "Arn": "string",
            "LocalMountPath": "string"
        }
    ],
    "ImageConfig": {
        "EntryPoint": [],
        "Command": [],
        "WorkingDirectory": "string"
    }
}'

Response Example

200 - Example 1

{
    "FunctionName": "string",
    "FunctionArn": "string",
    "Runtime": "nodejs",
    "Role": "string",
    "Handler": "string",
    "CodeSize": 0,
    "Description": "string",
    "Timeout": 0,
    "MemorySize": 0,
    "LastModified": "string",
    "CodeSha256": "string",
    "Version": "string",
    "VpcConfig": {
        "SubnetIds": [],
        "SecurityGroupIds": [],
        "VpcId": "string"
    },
    "DeadLetterConfig": {
        "TargetArn": "string"
    },
    "Environment": {
        "Variables": {
            "property1": "pa$$word",
            "property2": "pa$$word"
        },
        "Error": {
            "ErrorCode": "string",
            "Message": "string"
        }
    },
    "KMSKeyArn": "string",
    "TracingConfig": {
        "Mode": "Active"
    },
    "MasterArn": "string",
    "RevisionId": "string",
    "Layers": [],
    "State": "Pending",
    "StateReason": "string",
    "StateReasonCode": "Idle",
    "LastUpdateStatus": "Successful",
    "LastUpdateStatusReason": "string",
    "LastUpdateStatusReasonCode": "EniLimitExceeded",
    "FileSystemConfigs": [],
    "PackageType": "Zip",
    "ImageConfigResponse": {
        "ImageConfig": {
            "EntryPoint": [],
            "Command": [],
            "WorkingDirectory": "string"
        },
        "Error": {
            "ErrorCode": "string",
            "Message": "string"
        }
    },
    "SigningProfileVersionArn": "string",
    "SigningJobArn": "string"
}

Request

Path Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠480ServiceException

🟠481ResourceNotFoundException

🟠482InvalidParameterValueException

🟠483TooManyRequestsException

🟠484ResourceConflictException

🟠485PreconditionFailedException

🟠486CodeVerificationFailedException

🟠487InvalidCodeSignatureException

🟠488CodeSigningConfigNotFoundException

Modified at 2022-09-10 19:49:51

/2015-03-31/functions/{FunctionName}/configuration

/2018-10-31/layers