Network.AWS.Lambda

AWS Lambda

Overview

This is the AWS Lambda API Reference. The AWS Lambda Developer Guide provides additional information. For the service overview, go to What is AWS Lambda, and for information about how the service works, go to AWS Lambda: How it Works in the AWS Lambda Developer Guide.

See: AWS API Reference

Service Configuration

lambda :: Service

API version '2015-03-31' of the Amazon Lambda SDK configuration.

Errors

Error matchers are designed for use with the functions provided by Control.Exception.Lens. This allows catching (and rethrowing) service specific errors returned by Lambda.

PolicyLengthExceededException

_PolicyLengthExceededException :: AsError a => Getting (First ServiceError) a ServiceError

Lambda function access policy is limited to 20 KB.

UnsupportedMediaTypeException

_UnsupportedMediaTypeException :: AsError a => Getting (First ServiceError) a ServiceError

Prism for UnsupportedMediaTypeException' errors.

InvalidRequestContentException

_InvalidRequestContentException :: AsError a => Getting (First ServiceError) a ServiceError

The request body could not be parsed as JSON.

InvalidParameterValueException

_InvalidParameterValueException :: AsError a => Getting (First ServiceError) a ServiceError

One of the parameters in the request is invalid. For example, if you provided an IAM role for AWS Lambda to assume in the CreateFunction or the UpdateFunctionConfiguration API, that AWS Lambda is unable to assume you will get this exception.

RequestTooLargeException

_RequestTooLargeException :: AsError a => Getting (First ServiceError) a ServiceError

Prism for RequestTooLargeException' errors.

TooManyRequestsException

_TooManyRequestsException :: AsError a => Getting (First ServiceError) a ServiceError

Prism for TooManyRequestsException' errors.

ServiceException

_ServiceException :: AsError a => Getting (First ServiceError) a ServiceError

The AWS Lambda service encountered an internal error.

CodeStorageExceededException

_CodeStorageExceededException :: AsError a => Getting (First ServiceError) a ServiceError

Prism for CodeStorageExceededException' errors.

ResourceConflictException

_ResourceConflictException :: AsError a => Getting (First ServiceError) a ServiceError

The resource already exists.

ResourceNotFoundException

_ResourceNotFoundException :: AsError a => Getting (First ServiceError) a ServiceError

The resource (for example, a Lambda function or access policy statement) specified in the request does not exist.

Waiters

Waiters poll by repeatedly sending a request until some remote success condition configured by the Wait specification is fulfilled. The Wait specification determines how many attempts should be made, in addition to delay and retry strategies.

Operations

Some AWS operations return results that are incomplete and require subsequent requests in order to obtain the entire result set. The process of sending subsequent requests to continue where a previous request left off is called pagination. For example, the ListObjects operation of Amazon S3 returns up to 1000 objects at a time, and you must send subsequent requests with the appropriate Marker in order to retrieve the next page of results.

Operations that have an AWSPager instance can transparently perform subsequent requests, correctly setting Markers and other request facets to iterate through the entire result set of a truncated API operation. Operations which support this have an additional note in the documentation.

Many operations have the ability to filter results on the server side. See the individual operation parameters for details.

GetFunctionConfiguration

module Network.AWS.Lambda.GetFunctionConfiguration

UpdateEventSourceMapping

module Network.AWS.Lambda.UpdateEventSourceMapping

DeleteEventSourceMapping

module Network.AWS.Lambda.DeleteEventSourceMapping

RemovePermission

module Network.AWS.Lambda.RemovePermission

Invoke

module Network.AWS.Lambda.Invoke

GetEventSourceMapping

module Network.AWS.Lambda.GetEventSourceMapping

CreateFunction

module Network.AWS.Lambda.CreateFunction

CreateEventSourceMapping

module Network.AWS.Lambda.CreateEventSourceMapping

GetFunction

module Network.AWS.Lambda.GetFunction

ListEventSourceMappings (Paginated)

module Network.AWS.Lambda.ListEventSourceMappings

AddPermission

module Network.AWS.Lambda.AddPermission

DeleteFunction

module Network.AWS.Lambda.DeleteFunction

UpdateFunctionConfiguration

module Network.AWS.Lambda.UpdateFunctionConfiguration

ListFunctions (Paginated)

module Network.AWS.Lambda.ListFunctions

UpdateFunctionCode

module Network.AWS.Lambda.UpdateFunctionCode

GetPolicy

module Network.AWS.Lambda.GetPolicy

Types

EventSourcePosition

data EventSourcePosition

Constructors

Latest

TrimHorizon

Instances

Enum EventSourcePosition

Eq EventSourcePosition

Data EventSourcePosition

Ord EventSourcePosition

Read EventSourcePosition

Show EventSourcePosition

Generic EventSourcePosition

ToJSON EventSourcePosition

Hashable EventSourcePosition

ToHeader EventSourcePosition

ToQuery EventSourcePosition

ToByteString EventSourcePosition

FromText EventSourcePosition

ToText EventSourcePosition

Typeable * EventSourcePosition

type Rep EventSourcePosition

InvocationType

data InvocationType

Constructors

DryRun

Event

RequestResponse

Instances

Enum InvocationType

Eq InvocationType

Data InvocationType

Ord InvocationType

Read InvocationType

Show InvocationType

Generic InvocationType

ToJSON InvocationType

Hashable InvocationType

ToHeader InvocationType

ToQuery InvocationType

ToByteString InvocationType

FromText InvocationType

ToText InvocationType

Typeable * InvocationType

type Rep InvocationType

LogType

data LogType

Constructors

None

Tail

Instances

Enum LogType

Eq LogType

Data LogType

Ord LogType

Read LogType

Show LogType

Generic LogType

ToJSON LogType

Hashable LogType

ToHeader LogType

ToQuery LogType

ToByteString LogType

FromText LogType

ToText LogType

Typeable * LogType

type Rep LogType

Runtime

data Runtime

Constructors

JAVA8

Nodejs

Instances

Enum Runtime

Eq Runtime

Data Runtime

Ord Runtime

Read Runtime

Show Runtime

Generic Runtime

ToJSON Runtime

FromJSON Runtime

Hashable Runtime

ToHeader Runtime

ToQuery Runtime

ToByteString Runtime

FromText Runtime

ToText Runtime

Typeable * Runtime

type Rep Runtime

EventSourceMappingConfiguration

data EventSourceMappingConfiguration

Describes mapping between an Amazon Kinesis stream and a Lambda function.

See: eventSourceMappingConfiguration smart constructor.

Instances

Eq EventSourceMappingConfiguration

Data EventSourceMappingConfiguration

Read EventSourceMappingConfiguration

Show EventSourceMappingConfiguration

Generic EventSourceMappingConfiguration

FromJSON EventSourceMappingConfiguration

Typeable * EventSourceMappingConfiguration

type Rep EventSourceMappingConfiguration

eventSourceMappingConfiguration :: EventSourceMappingConfiguration

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

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

• esmcEventSourceARN
• esmcFunctionARN
• esmcState
• esmcUUId
• esmcLastProcessingResult
• esmcBatchSize
• esmcStateTransitionReason
• esmcLastModified

esmcEventSourceARN :: Lens' EventSourceMappingConfiguration (Maybe Text)

The Amazon Resource Name (ARN) of the Amazon Kinesis stream that is the source of events.

esmcFunctionARN :: Lens' EventSourceMappingConfiguration (Maybe Text)

The Lambda function to invoke when AWS Lambda detects an event on the stream.

esmcState :: Lens' EventSourceMappingConfiguration (Maybe Text)

The state of the event source mapping. It can be "Creating", "Enabled", "Disabled", "Enabling", "Disabling", "Updating", or "Deleting".

esmcUUId :: Lens' EventSourceMappingConfiguration (Maybe Text)

The AWS Lambda assigned opaque identifier for the mapping.

esmcLastProcessingResult :: Lens' EventSourceMappingConfiguration (Maybe Text)

The result of the last AWS Lambda invocation of your Lambda function.

esmcBatchSize :: Lens' EventSourceMappingConfiguration (Maybe Natural)

The largest number of records that AWS Lambda will retrieve from your event source at the time of invoking your function. Your function receives an event with all the retrieved records.

esmcStateTransitionReason :: Lens' EventSourceMappingConfiguration (Maybe Text)

The reason the event source mapping is in its current state. It is either user-requested or an AWS Lambda-initiated state transition.

esmcLastModified :: Lens' EventSourceMappingConfiguration (Maybe UTCTime)

The UTC time string indicating the last time the event mapping was updated.

FunctionCode

data FunctionCode

The code for the Lambda function.

See: functionCode smart constructor.

Instances

Eq FunctionCode

Data FunctionCode

Read FunctionCode

Show FunctionCode

Generic FunctionCode

ToJSON FunctionCode

Typeable * FunctionCode

type Rep FunctionCode

functionCode :: FunctionCode

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

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

• fcS3ObjectVersion
• fcS3Key
• fcZipFile
• fcS3Bucket

fcS3ObjectVersion :: Lens' FunctionCode (Maybe Text)

The Amazon S3 object (the deployment package) version you want to upload.

fcS3Key :: Lens' FunctionCode (Maybe Text)

The Amazon S3 object (the deployment package) key name you want to upload.

fcZipFile :: Lens' FunctionCode (Maybe ByteString)

A base64-encoded .zip file containing your deployment package. For more information about creating a .zip file, go to Execution Permissions in the AWS Lambda Developer Guide.

Note: This Lens automatically encodes and decodes Base64 data, despite what the AWS documentation might say. The underlying isomorphism will encode to Base64 representation during serialisation, and decode from Base64 representation during deserialisation. This Lens accepts and returns only raw unencoded data.

fcS3Bucket :: Lens' FunctionCode (Maybe Text)

Amazon S3 bucket name where the .zip file containing your deployment package is stored. This bucket must reside in the same AWS region where you are creating the Lambda function.

FunctionCodeLocation

data FunctionCodeLocation

The object for the Lambda function location.

See: functionCodeLocation smart constructor.

Instances

Eq FunctionCodeLocation

Data FunctionCodeLocation

Read FunctionCodeLocation

Show FunctionCodeLocation

Generic FunctionCodeLocation

FromJSON FunctionCodeLocation

Typeable * FunctionCodeLocation

type Rep FunctionCodeLocation

functionCodeLocation :: FunctionCodeLocation

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

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

• fclLocation
• fclRepositoryType

fclLocation :: Lens' FunctionCodeLocation (Maybe Text)

The presigned URL you can use to download the function's .zip file that you previously uploaded. The URL is valid for up to 10 minutes.

fclRepositoryType :: Lens' FunctionCodeLocation (Maybe Text)

The repository from which you can download the function.

FunctionConfiguration

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

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:

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

fcRuntime :: Lens' FunctionConfiguration (Maybe Runtime)

The runtime environment for the Lambda function.

fcMemorySize :: Lens' FunctionConfiguration (Maybe Natural)

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

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.