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.

If you are using versioning, you can also publish a version of the Lambda function you are creating using the Publish parameter. For more information about versioning, see AWS Lambda Function Versioning and Aliases .

This operation requires permission for the lambda:CreateFunction action.

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 - 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.
• cfKMSKeyARN - The Amazon Resource Name (ARN) of the KMS key used to encrypt your function's environment variables. If not provided, AWS Lambda will use a default service key.
• cfEnvironment - Undocumented member.
• cfDeadLetterConfig - The parent object that contains the target ARN (Amazon Resource Name) of an Amazon SQS queue or Amazon SNS topic.
• cfVPCConfig - If your Lambda function accesses resources in a VPC, you provide this parameter identifying the list of security group IDs and subnet IDs. These must belong to the same VPC. You must provide at least one security group and one subnet ID.
• cfTimeout - 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 - A short, user-defined function description. Lambda does not use this value. Assign a meaningful description as you see fit.
• cfPublish - This boolean parameter can be used to request AWS Lambda to create the Lambda function and publish a version as an atomic operation.
• cfFunctionName - The name you want to assign to the function you are uploading. 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 - The runtime environment for the Lambda function you are uploading. To use the Node.js runtime v4.3, set the value to "nodejs4.3". To use earlier runtime (v0.10.42), set the value to "nodejs".
• cfRole - 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 - 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 - The code for the Lambda function.

data CreateFunction

See: createFunction smart constructor.

Instances

Eq CreateFunction

Methods

(==) :: CreateFunction -> CreateFunction -> Bool

(/=) :: CreateFunction -> CreateFunction -> Bool

Data CreateFunction

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateFunction -> c CreateFunction

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateFunction

toConstr :: CreateFunction -> Constr

dataTypeOf :: CreateFunction -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateFunction)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateFunction)

gmapT :: (forall b. Data b => b -> b) -> CreateFunction -> CreateFunction

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateFunction -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateFunction -> r

gmapQ :: (forall d. Data d => d -> u) -> CreateFunction -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateFunction -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateFunction -> m CreateFunction

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateFunction -> m CreateFunction

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateFunction -> m CreateFunction

Read CreateFunction

Methods

readsPrec :: Int -> ReadS CreateFunction

readList :: ReadS [CreateFunction]

readPrec :: ReadPrec CreateFunction

readListPrec :: ReadPrec [CreateFunction]

Show CreateFunction

Methods

showsPrec :: Int -> CreateFunction -> ShowS

show :: CreateFunction -> String

showList :: [CreateFunction] -> ShowS

Generic CreateFunction

Associated Types

type Rep CreateFunction :: * -> *

Methods

from :: CreateFunction -> Rep CreateFunction x

to :: Rep CreateFunction x -> CreateFunction

Hashable CreateFunction

Methods

hashWithSalt :: Int -> CreateFunction -> Int

hash :: CreateFunction -> Int

ToJSON CreateFunction

Methods

toJSON :: CreateFunction -> Value

toEncoding :: CreateFunction -> Encoding

toJSONList :: [CreateFunction] -> Value

toEncodingList :: [CreateFunction] -> Encoding

NFData CreateFunction

Methods

rnf :: CreateFunction -> ()

AWSRequest CreateFunction

Associated Types

type Rs CreateFunction :: *

Methods

request :: CreateFunction -> Request CreateFunction

response :: MonadResource m => Logger -> Service -> Proxy * CreateFunction -> ClientResponse -> m (Response CreateFunction)

ToPath CreateFunction

Methods

toPath :: CreateFunction -> ByteString

ToHeaders CreateFunction

Methods

toHeaders :: CreateFunction -> [Header]

ToQuery CreateFunction

Methods

toQuery :: CreateFunction -> QueryString

type Rep CreateFunction

type Rep CreateFunction = D1 (MetaData "CreateFunction" "Network.AWS.Lambda.CreateFunction" "amazonka-lambda-1.4.5-K0Zcc9dQTk78nHWncyJsNe" False) (C1 (MetaCons "CreateFunction'" PrefixI True) ((:*:) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_cfMemorySize") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat))) ((:*:) (S1 (MetaSel (Just Symbol "_cfKMSKeyARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_cfEnvironment") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Environment))))) ((:*:) (S1 (MetaSel (Just Symbol "_cfDeadLetterConfig") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe DeadLetterConfig))) ((:*:) (S1 (MetaSel (Just Symbol "_cfVPCConfig") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe VPCConfig))) (S1 (MetaSel (Just Symbol "_cfTimeout") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat)))))) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_cfDescription") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_cfPublish") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool))) (S1 (MetaSel (Just Symbol "_cfFunctionName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_cfRuntime") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Runtime)) (S1 (MetaSel (Just Symbol "_cfRole") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))) ((:*:) (S1 (MetaSel (Just Symbol "_cfHandler") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) (S1 (MetaSel (Just Symbol "_cfCode") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 FunctionCode)))))))

type Rs 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.

cfKMSKeyARN :: Lens' CreateFunction (Maybe Text)

The Amazon Resource Name (ARN) of the KMS key used to encrypt your function's environment variables. If not provided, AWS Lambda will use a default service key.

cfEnvironment :: Lens' CreateFunction (Maybe Environment)

Undocumented member.

cfDeadLetterConfig :: Lens' CreateFunction (Maybe DeadLetterConfig)

The parent object that contains the target ARN (Amazon Resource Name) of an Amazon SQS queue or Amazon SNS topic.

cfVPCConfig :: Lens' CreateFunction (Maybe VPCConfig)

If your Lambda function accesses resources in a VPC, you provide this parameter identifying the list of security group IDs and subnet IDs. These must belong to the same VPC. You must provide at least one security group and one subnet ID.

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.

cfPublish :: Lens' CreateFunction (Maybe Bool)

This boolean parameter can be used to request AWS Lambda to create the Lambda function and publish a version as an atomic operation.

cfFunctionName :: Lens' CreateFunction Text

The name you want to assign to the function you are uploading. 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. To use the Node.js runtime v4.3, set the value to "nodejs4.3". To use earlier runtime (v0.10.42), set the value to "nodejs".

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 - The memory size, in MB, you configured for the function. Must be a multiple of 64 MB.
• fcRuntime - The runtime environment for the Lambda function. To use the Node.js runtime v4.3, set the value to "nodejs4.3". To use earlier runtime (v0.10.42), set the value to "nodejs".
• fcFunctionARN - The Amazon Resource Name (ARN) assigned to the function.
• fcKMSKeyARN - The Amazon Resource Name (ARN) of the KMS key used to encrypt your function's environment variables. If empty, it means you are using the AWS Lambda default service key.
• fcEnvironment - The parent object that contains your environment's configuration settings.
• fcDeadLetterConfig - The parent object that contains the target ARN (Amazon Resource Name) of an Amazon SQS queue or Amazon SNS topic.
• fcRole - 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.
• fcVPCConfig - VPC configuration associated with your Lambda function.
• fcVersion - The version of the Lambda function.
• fcFunctionName - The name of the function.
• fcCodeSize - The size, in bytes, of the function .zip file you uploaded.
• fcHandler - The function Lambda calls to begin executing your function.
• fcTimeout - 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 - The time stamp of the last time you updated the function.
• fcCodeSha256 - It is the SHA256 hash of your function deployment package.
• fcDescription - The user-provided description.

data FunctionConfiguration

A complex type that describes function metadata.

See: functionConfiguration smart constructor.

Instances

Eq FunctionConfiguration

Methods

(==) :: FunctionConfiguration -> FunctionConfiguration -> Bool

(/=) :: FunctionConfiguration -> FunctionConfiguration -> Bool

Data FunctionConfiguration

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> FunctionConfiguration -> c FunctionConfiguration

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c FunctionConfiguration

toConstr :: FunctionConfiguration -> Constr

dataTypeOf :: FunctionConfiguration -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c FunctionConfiguration)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c FunctionConfiguration)

gmapT :: (forall b. Data b => b -> b) -> FunctionConfiguration -> FunctionConfiguration

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> FunctionConfiguration -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> FunctionConfiguration -> r

gmapQ :: (forall d. Data d => d -> u) -> FunctionConfiguration -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> FunctionConfiguration -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> FunctionConfiguration -> m FunctionConfiguration

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> FunctionConfiguration -> m FunctionConfiguration

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> FunctionConfiguration -> m FunctionConfiguration

Read FunctionConfiguration

Methods

readsPrec :: Int -> ReadS FunctionConfiguration

readList :: ReadS [FunctionConfiguration]

readPrec :: ReadPrec FunctionConfiguration

readListPrec :: ReadPrec [FunctionConfiguration]

Show FunctionConfiguration

Methods

showsPrec :: Int -> FunctionConfiguration -> ShowS

show :: FunctionConfiguration -> String

showList :: [FunctionConfiguration] -> ShowS

Generic FunctionConfiguration

Associated Types

type Rep FunctionConfiguration :: * -> *

Methods

from :: FunctionConfiguration -> Rep FunctionConfiguration x

to :: Rep FunctionConfiguration x -> FunctionConfiguration

Hashable FunctionConfiguration

Methods

hashWithSalt :: Int -> FunctionConfiguration -> Int

hash :: FunctionConfiguration -> Int

FromJSON FunctionConfiguration

Methods

parseJSON :: Value -> Parser FunctionConfiguration

parseJSONList :: Value -> Parser [FunctionConfiguration]

NFData FunctionConfiguration

Methods

rnf :: FunctionConfiguration -> ()

type Rep FunctionConfiguration

type Rep FunctionConfiguration = D1 (MetaData "FunctionConfiguration" "Network.AWS.Lambda.Types.Product" "amazonka-lambda-1.4.5-K0Zcc9dQTk78nHWncyJsNe" False) (C1 (MetaCons "FunctionConfiguration'" PrefixI True) ((:*:) ((:*:) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_fcMemorySize") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat))) (S1 (MetaSel (Just Symbol "_fcRuntime") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Runtime)))) ((:*:) (S1 (MetaSel (Just Symbol "_fcFunctionARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_fcKMSKeyARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))))) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_fcEnvironment") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe EnvironmentResponse))) (S1 (MetaSel (Just Symbol "_fcDeadLetterConfig") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe DeadLetterConfig)))) ((:*:) (S1 (MetaSel (Just Symbol "_fcRole") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_fcVPCConfig") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe VPCConfigResponse)))))) ((:*:) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_fcVersion") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_fcFunctionName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))) ((:*:) (S1 (MetaSel (Just Symbol "_fcCodeSize") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Integer))) (S1 (MetaSel (Just Symbol "_fcHandler") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))))) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_fcTimeout") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat))) (S1 (MetaSel (Just Symbol "_fcLastModified") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))) ((:*:) (S1 (MetaSel (Just Symbol "_fcCodeSha256") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_fcDescription") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))))))))

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. To use the Node.js runtime v4.3, set the value to "nodejs4.3". To use earlier runtime (v0.10.42), set the value to "nodejs".

fcFunctionARN :: Lens' FunctionConfiguration (Maybe Text)

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

fcKMSKeyARN :: Lens' FunctionConfiguration (Maybe Text)

The Amazon Resource Name (ARN) of the KMS key used to encrypt your function's environment variables. If empty, it means you are using the AWS Lambda default service key.

fcEnvironment :: Lens' FunctionConfiguration (Maybe EnvironmentResponse)

The parent object that contains your environment's configuration settings.

fcDeadLetterConfig :: Lens' FunctionConfiguration (Maybe DeadLetterConfig)

The parent object that contains the target ARN (Amazon Resource Name) of an Amazon SQS queue or Amazon SNS topic.

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.

fcVPCConfig :: Lens' FunctionConfiguration (Maybe VPCConfigResponse)

VPC configuration associated with your Lambda function.

fcVersion :: Lens' FunctionConfiguration (Maybe Text)

The version of the Lambda function.

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 time stamp of the last time you updated the function.

fcCodeSha256 :: Lens' FunctionConfiguration (Maybe Text)

It is the SHA256 hash of your function deployment package.

fcDescription :: Lens' FunctionConfiguration (Maybe Text)

The user-provided description.