Network.AWS.Lambda.CreateFunction

Creates a new Lambda function. The function metadata is created from the request parameters, and the code for the function is provided by a .zip file in the request body. If the function name already exists, the operation will fail. Note that the function name is case-sensitive.

This operation requires permission for the 'lambda:CreateFunction' action.

See: AWS API Reference for CreateFunction.

Creating a Request

createFunction

Arguments

:: Text

cfFunctionName

-> Runtime

cfRuntime

-> Text

cfRole

-> Text

cfHandler

-> FunctionCode

cfCode

-> CreateFunction

Creates a value of CreateFunction with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• cfMemorySize
• cfTimeout
• cfDescription
• cfFunctionName
• cfRuntime
• cfRole
• cfHandler
• cfCode

data CreateFunction

See: createFunction smart constructor.

Instances

Eq CreateFunction

Data CreateFunction

Read CreateFunction

Show CreateFunction

Generic CreateFunction

ToJSON CreateFunction

AWSRequest CreateFunction

ToPath CreateFunction

ToHeaders CreateFunction

ToQuery CreateFunction

Typeable * CreateFunction

type Rep CreateFunction

type Rs CreateFunction = FunctionConfiguration

Request Lenses

cfMemorySize :: Lens' CreateFunction (Maybe Natural)

The amount of memory, in MB, your Lambda function is given. Lambda uses this memory size to infer the amount of CPU and memory allocated to your function. Your function use-case determines your CPU and memory requirements. For example, a database operation might need less memory compared to an image processing function. The default value is 128 MB. The value must be a multiple of 64 MB.

cfTimeout :: Lens' CreateFunction (Maybe Natural)

The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.

cfDescription :: Lens' CreateFunction (Maybe Text)

A short, user-defined function description. Lambda does not use this value. Assign a meaningful description as you see fit.

cfFunctionName :: Lens' CreateFunction Text

The name you want to assign to the function you are uploading. You can specify an unqualified function name (for example, "Thumbnail") or you can specify Amazon Resource Name (ARN) of the function (for example, "arn:aws:lambda:us-west-2:account-id:function:ThumbNail"). AWS Lambda also allows you to specify only the account ID qualifier (for example, "account-id:Thumbnail"). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 character in length. The function names appear in the console and are returned in the ListFunctions API. Function names are used to specify functions to other AWS Lambda APIs, such as Invoke.

cfRuntime :: Lens' CreateFunction Runtime

The runtime environment for the Lambda function you are uploading. Currently, Lambda supports "java" and "nodejs" as the runtime.

cfRole :: Lens' CreateFunction Text

The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources. For more information, see AWS Lambda: How it Works

cfHandler :: Lens' CreateFunction Text

The function within your code that Lambda calls to begin execution. For Node.js, it is the module-name.export value in your function. For Java, it can be 'package.class-name::handler' or 'package.class-name'. For more information, see Lambda Function Handler (Java).

cfCode :: Lens' CreateFunction FunctionCode

The code for the Lambda function.

Destructuring the Response

functionConfiguration :: FunctionConfiguration

Creates a value of FunctionConfiguration with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• fcMemorySize
• fcRuntime
• fcFunctionARN
• fcRole
• fcFunctionName
• fcCodeSize
• fcHandler
• fcTimeout
• fcLastModified
• fcDescription

data FunctionConfiguration

A complex type that describes function metadata.

See: functionConfiguration smart constructor.

Instances

Eq FunctionConfiguration

Data FunctionConfiguration

Read FunctionConfiguration

Show FunctionConfiguration

Generic FunctionConfiguration

FromJSON FunctionConfiguration

Typeable * FunctionConfiguration

type Rep FunctionConfiguration

Response Lenses

fcMemorySize :: Lens' FunctionConfiguration (Maybe Natural)

The memory size, in MB, you configured for the function. Must be a multiple of 64 MB.

fcRuntime :: Lens' FunctionConfiguration (Maybe Runtime)

The runtime environment for the Lambda function.

fcFunctionARN :: Lens' FunctionConfiguration (Maybe Text)

The Amazon Resource Name (ARN) assigned to the function.

fcRole :: Lens' FunctionConfiguration (Maybe Text)

The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources.

fcFunctionName :: Lens' FunctionConfiguration (Maybe Text)

The name of the function.

fcCodeSize :: Lens' FunctionConfiguration (Maybe Integer)

The size, in bytes, of the function .zip file you uploaded.

fcHandler :: Lens' FunctionConfiguration (Maybe Text)

The function Lambda calls to begin executing your function.

fcTimeout :: Lens' FunctionConfiguration (Maybe Natural)

The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.

fcLastModified :: Lens' FunctionConfiguration (Maybe Text)

The timestamp of the last time you updated the function.

fcDescription :: Lens' FunctionConfiguration (Maybe Text)

The user-provided description.