amazonka-lambda-1.6.1: Amazon Lambda SDK.

Copyright(c) 2013-2018 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.Lambda.CreateFunction

Contents

Description

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.

Synopsis

Creating a Request

createFunction Source #

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. For more information, see dlq .
  • 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.
  • cfTracingConfig - The parent object that contains your function's tracing settings.
  • cfDescription - A short, user-defined function description. Lambda does not use this value. Assign a meaningful description as you see fit.
  • cfTags - The list of tags (key-value pairs) assigned to the new function. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide .
  • 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 API operations, such as Invoke . Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.
  • cfRuntime - The runtime environment for the Lambda function you are uploading. To use the Python runtime v3.6, set the value to "python3.6". To use the Python runtime v2.7, set the value to "python2.7". To use the Node.js runtime v6.10, set the value to "nodejs6.10". To use the Node.js runtime v4.3, set the value to "nodejs4.3". To use the .NET Core runtime v1.0, set the value to "dotnetcore1.0". To use the .NET Core runtime v2.0, set the value to "dotnetcore2.0".
  • 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 Source #

See: createFunction smart constructor.

Instances
Eq CreateFunction Source # 
Instance details

Defined in Network.AWS.Lambda.CreateFunction

Data CreateFunction Source # 
Instance details

Defined in Network.AWS.Lambda.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 #

Show CreateFunction Source # 
Instance details

Defined in Network.AWS.Lambda.CreateFunction

Generic CreateFunction Source # 
Instance details

Defined in Network.AWS.Lambda.CreateFunction

Associated Types

type Rep CreateFunction :: Type -> Type #

Hashable CreateFunction Source # 
Instance details

Defined in Network.AWS.Lambda.CreateFunction

ToJSON CreateFunction Source # 
Instance details

Defined in Network.AWS.Lambda.CreateFunction

AWSRequest CreateFunction Source # 
Instance details

Defined in Network.AWS.Lambda.CreateFunction

Associated Types

type Rs CreateFunction :: Type #

ToHeaders CreateFunction Source # 
Instance details

Defined in Network.AWS.Lambda.CreateFunction

ToPath CreateFunction Source # 
Instance details

Defined in Network.AWS.Lambda.CreateFunction

ToQuery CreateFunction Source # 
Instance details

Defined in Network.AWS.Lambda.CreateFunction

NFData CreateFunction Source # 
Instance details

Defined in Network.AWS.Lambda.CreateFunction

Methods

rnf :: CreateFunction -> () #

type Rep CreateFunction Source # 
Instance details

Defined in Network.AWS.Lambda.CreateFunction

type Rep CreateFunction = D1 (MetaData "CreateFunction" "Network.AWS.Lambda.CreateFunction" "amazonka-lambda-1.6.1-KQvkrTCQjBWL6Bwjq8xw0f" False) (C1 (MetaCons "CreateFunction'" PrefixI True) (((S1 (MetaSel (Just "_cfMemorySize") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat)) :*: (S1 (MetaSel (Just "_cfKMSKeyARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_cfEnvironment") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Environment)))) :*: ((S1 (MetaSel (Just "_cfDeadLetterConfig") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe DeadLetterConfig)) :*: S1 (MetaSel (Just "_cfVPCConfig") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe VPCConfig))) :*: (S1 (MetaSel (Just "_cfTimeout") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat)) :*: S1 (MetaSel (Just "_cfTracingConfig") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe TracingConfig))))) :*: (((S1 (MetaSel (Just "_cfDescription") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_cfTags") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe (Map Text Text)))) :*: (S1 (MetaSel (Just "_cfPublish") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 (MetaSel (Just "_cfFunctionName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))) :*: ((S1 (MetaSel (Just "_cfRuntime") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Runtime) :*: S1 (MetaSel (Just "_cfRole") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) :*: (S1 (MetaSel (Just "_cfHandler") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text) :*: S1 (MetaSel (Just "_cfCode") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 FunctionCode))))))
type Rs CreateFunction Source # 
Instance details

Defined in Network.AWS.Lambda.CreateFunction

Request Lenses

cfMemorySize :: Lens' CreateFunction (Maybe Natural) Source #

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) Source #

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.

cfDeadLetterConfig :: Lens' CreateFunction (Maybe DeadLetterConfig) Source #

The parent object that contains the target ARN (Amazon Resource Name) of an Amazon SQS queue or Amazon SNS topic. For more information, see dlq .

cfVPCConfig :: Lens' CreateFunction (Maybe VPCConfig) Source #

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) Source #

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.

cfTracingConfig :: Lens' CreateFunction (Maybe TracingConfig) Source #

The parent object that contains your function's tracing settings.

cfDescription :: Lens' CreateFunction (Maybe Text) Source #

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

cfTags :: Lens' CreateFunction (HashMap Text Text) Source #

The list of tags (key-value pairs) assigned to the new function. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide .

cfPublish :: Lens' CreateFunction (Maybe Bool) Source #

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 Source #

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 API operations, such as Invoke . Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

cfRuntime :: Lens' CreateFunction Runtime Source #

The runtime environment for the Lambda function you are uploading. To use the Python runtime v3.6, set the value to "python3.6". To use the Python runtime v2.7, set the value to "python2.7". To use the Node.js runtime v6.10, set the value to "nodejs6.10". To use the Node.js runtime v4.3, set the value to "nodejs4.3". To use the .NET Core runtime v1.0, set the value to "dotnetcore1.0". To use the .NET Core runtime v2.0, set the value to "dotnetcore2.0".

cfRole :: Lens' CreateFunction Text Source #

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 Source #

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 Source #

The code for the Lambda function.

Destructuring the Response

functionConfiguration :: FunctionConfiguration Source #

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.
  • 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. For more information, see dlq .
  • 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. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.
  • 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. The time stamp is conveyed as a string complying with ISO-8601 in this way YYYY-MM-DDThh:mm:ssTZD (e.g., 1997-07-16T19:20:30+01:00). For more information, see Date and Time Formats .
  • fcCodeSha256 - It is the SHA256 hash of your function deployment package.
  • fcTracingConfig - The parent object that contains your function's tracing settings.
  • fcDescription - The user-provided description.
  • fcRevisionId - Represents the latest updated revision of the function or alias.
  • fcMasterARN - Returns the ARN (Amazon Resource Name) of the master function.

data FunctionConfiguration Source #

A complex type that describes function metadata.

See: functionConfiguration smart constructor.

Instances
Eq FunctionConfiguration Source # 
Instance details

Defined in Network.AWS.Lambda.Types.Product

Data FunctionConfiguration Source # 
Instance details

Defined in Network.AWS.Lambda.Types.Product

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 #

Show FunctionConfiguration Source # 
Instance details

Defined in Network.AWS.Lambda.Types.Product

Generic FunctionConfiguration Source # 
Instance details

Defined in Network.AWS.Lambda.Types.Product

Associated Types

type Rep FunctionConfiguration :: Type -> Type #

Hashable FunctionConfiguration Source # 
Instance details

Defined in Network.AWS.Lambda.Types.Product

FromJSON FunctionConfiguration Source # 
Instance details

Defined in Network.AWS.Lambda.Types.Product

NFData FunctionConfiguration Source # 
Instance details

Defined in Network.AWS.Lambda.Types.Product

Methods

rnf :: FunctionConfiguration -> () #

type Rep FunctionConfiguration Source # 
Instance details

Defined in Network.AWS.Lambda.Types.Product

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

Response Lenses

fcMemorySize :: Lens' FunctionConfiguration (Maybe Natural) Source #

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

fcRuntime :: Lens' FunctionConfiguration (Maybe Runtime) Source #

The runtime environment for the Lambda function.

fcFunctionARN :: Lens' FunctionConfiguration (Maybe Text) Source #

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

fcKMSKeyARN :: Lens' FunctionConfiguration (Maybe Text) Source #

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) Source #

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

fcDeadLetterConfig :: Lens' FunctionConfiguration (Maybe DeadLetterConfig) Source #

The parent object that contains the target ARN (Amazon Resource Name) of an Amazon SQS queue or Amazon SNS topic. For more information, see dlq .

fcRole :: Lens' FunctionConfiguration (Maybe Text) Source #

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) Source #

VPC configuration associated with your Lambda function.

fcVersion :: Lens' FunctionConfiguration (Maybe Text) Source #

The version of the Lambda function.

fcFunctionName :: Lens' FunctionConfiguration (Maybe Text) Source #

The name of the function. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

fcCodeSize :: Lens' FunctionConfiguration (Maybe Integer) Source #

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

fcHandler :: Lens' FunctionConfiguration (Maybe Text) Source #

The function Lambda calls to begin executing your function.

fcTimeout :: Lens' FunctionConfiguration (Maybe Natural) Source #

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) Source #

The time stamp of the last time you updated the function. The time stamp is conveyed as a string complying with ISO-8601 in this way YYYY-MM-DDThh:mm:ssTZD (e.g., 1997-07-16T19:20:30+01:00). For more information, see Date and Time Formats .

fcCodeSha256 :: Lens' FunctionConfiguration (Maybe Text) Source #

It is the SHA256 hash of your function deployment package.

fcTracingConfig :: Lens' FunctionConfiguration (Maybe TracingConfigResponse) Source #

The parent object that contains your function's tracing settings.

fcDescription :: Lens' FunctionConfiguration (Maybe Text) Source #

The user-provided description.

fcRevisionId :: Lens' FunctionConfiguration (Maybe Text) Source #

Represents the latest updated revision of the function or alias.

fcMasterARN :: Lens' FunctionConfiguration (Maybe Text) Source #

Returns the ARN (Amazon Resource Name) of the master function.