software.amazon.awscdk.services.lambda

Class Function

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.lambda.FunctionBase

software.amazon.awscdk.services.lambda.Function

All Implemented Interfaces:

IResource, IClientVpnConnectionHandler, IConnectable, IGrantable, IFunction, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

Direct Known Subclasses:

DockerImageFunction, NodejsFunction

@Generated(value="jsii-pacmak/1.30.0 (build adae23f)",
           date="2021-06-30T10:01:21.515Z")
 @Stability(value=Experimental)
public class Function
extends FunctionBase

(experimental) Deploys a file from inside the construct library as a function.

The supplied file is subject to the 4096 bytes limit of being embedded in a CloudFormation template.

The construct includes an associated role with the lambda.

This construct does not yet reproduce all features from the underlying resource library.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Function.Builder (experimental) A fluent builder for Function.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.lambda.IFunction

IFunction.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.ec2.IClientVpnConnectionHandler

IClientVpnConnectionHandler.Jsii$Default

Constructor Summary

Constructors

Modifier	Constructor and Description
	Function(software.constructs.Construct scope, String id, FunctionProps props)
protected	Function(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Function(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
Function	addEnvironment(String key, String value) (experimental) Adds an environment variable to this Lambda function.
Function	addEnvironment(String key, String value, EnvironmentOptions options) (experimental) Adds an environment variable to this Lambda function.
void	addLayers(ILayerVersion... layers) (experimental) Adds one or more Lambda Layers to this Lambda function.
static void	classifyVersionProperty(String propertyName, Boolean locked) (experimental) Record whether specific properties in the `AWS::Lambda::Function` resource should also be associated to the Version resource.
static IFunction	fromFunctionArn(software.constructs.Construct scope, String id, String functionArn) (experimental) Import a lambda function into the CDK using its ARN.
static IFunction	fromFunctionAttributes(software.constructs.Construct scope, String id, FunctionAttributes attrs) (experimental) Creates a Lambda function object which represents a function not defined within this stack.
protected Boolean	getCanCreatePermissions() (experimental) Whether the addPermission() call adds any permissions.
Version	getCurrentVersion() (experimental) Returns a `lambda.Version` which represents the current version of this Lambda function.
IQueue	getDeadLetterQueue() (experimental) The DLQ associated with this Lambda Function (this is an optional attribute).
String	getFunctionArn() (experimental) ARN of this function.
String	getFunctionName() (experimental) Name of this function.
IPrincipal	getGrantPrincipal() (experimental) The principal this Lambda Function is running as.
ILogGroup	getLogGroup() (experimental) The LogGroup where the Lambda function's logs are made available.
software.constructs.Node	getPermissionsNode() (experimental) The construct node where permissions are attached.
IRole	getRole() (experimental) Execution role associated with this function.
Runtime	getRuntime() (experimental) The runtime configured for this lambda.
static Metric	metricAll(String metricName) (experimental) Return the given named metric for this Lambda.
static Metric	metricAll(String metricName, MetricOptions props) (experimental) Return the given named metric for this Lambda.
static Metric	metricAllConcurrentExecutions() (experimental) Metric for the number of concurrent executions across all Lambdas.
static Metric	metricAllConcurrentExecutions(MetricOptions props) (experimental) Metric for the number of concurrent executions across all Lambdas.
static Metric	metricAllDuration() (experimental) Metric for the Duration executing all Lambdas.
static Metric	metricAllDuration(MetricOptions props) (experimental) Metric for the Duration executing all Lambdas.
static Metric	metricAllErrors() (experimental) Metric for the number of Errors executing all Lambdas.
static Metric	metricAllErrors(MetricOptions props) (experimental) Metric for the number of Errors executing all Lambdas.
static Metric	metricAllInvocations() (experimental) Metric for the number of invocations of all Lambdas.
static Metric	metricAllInvocations(MetricOptions props) (experimental) Metric for the number of invocations of all Lambdas.
static Metric	metricAllThrottles() (experimental) Metric for the number of throttled invocations of all Lambdas.
static Metric	metricAllThrottles(MetricOptions props) (experimental) Metric for the number of throttled invocations of all Lambdas.
static Metric	metricAllUnreservedConcurrentExecutions() (experimental) Metric for the number of unreserved concurrent executions across all Lambdas.
static Metric	metricAllUnreservedConcurrentExecutions(MetricOptions props) (experimental) Metric for the number of unreserved concurrent executions across all Lambdas.

Methods inherited from class software.amazon.awscdk.services.lambda.FunctionBase

addEventSource, addEventSourceMapping, addPermission, addToRolePolicy, configureAsyncInvoke, getConnections, getIsBoundToVpc, getLatestVersion, grantInvoke, metric, metric, metricDuration, metricDuration, metricErrors, metricErrors, metricInvocations, metricInvocations, metricThrottles, metricThrottles

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isResource

Methods inherited from class software.constructs.Construct

getNode, isConstruct, toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awscdk.IResource

getEnv, getStack

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

Function

protected Function(software.amazon.jsii.JsiiObjectRef objRef)

Function

protected Function(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

Function

@Stability(value=Experimental)
public Function(@NotNull
                                               software.constructs.Construct scope,
                                               @NotNull
                                               String id,
                                               @NotNull
                                               FunctionProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

classifyVersionProperty

@Stability(value=Experimental)
public static void classifyVersionProperty(@NotNull
                                                                          String propertyName,
                                                                          @NotNull
                                                                          Boolean locked)

(experimental) Record whether specific properties in the `AWS::Lambda::Function` resource should also be associated to the Version resource.

See 'currentVersion' section in the module README for more details.

Parameters:

propertyName - The property to classify. This parameter is required.

locked - whether the property should be associated to the version or not. This parameter is required.

fromFunctionArn

@Stability(value=Experimental)
 @NotNull
public static IFunction fromFunctionArn(@NotNull
                                                                                 software.constructs.Construct scope,
                                                                                 @NotNull
                                                                                 String id,
                                                                                 @NotNull
                                                                                 String functionArn)

(experimental) Import a lambda function into the CDK using its ARN.

Parameters:

scope - This parameter is required.

id - This parameter is required.

functionArn - This parameter is required.

fromFunctionAttributes

@Stability(value=Experimental)
 @NotNull
public static IFunction fromFunctionAttributes(@NotNull
                                                                                        software.constructs.Construct scope,
                                                                                        @NotNull
                                                                                        String id,
                                                                                        @NotNull
                                                                                        FunctionAttributes attrs)

(experimental) Creates a Lambda function object which represents a function not defined within this stack.

Parameters:

scope - The parent construct. This parameter is required.

id - The name of the lambda construct. This parameter is required.

attrs - the attributes of the function to import. This parameter is required.

metricAll

@Stability(value=Experimental)
 @NotNull
public static Metric metricAll(@NotNull
                                                                        String metricName,
                                                                        @Nullable
                                                                        MetricOptions props)

(experimental) Return the given named metric for this Lambda.

Parameters:

metricName - This parameter is required.

props -

metricAll

@Stability(value=Experimental)
 @NotNull
public static Metric metricAll(@NotNull
                                                                        String metricName)

(experimental) Return the given named metric for this Lambda.

Parameters:

metricName - This parameter is required.

metricAllConcurrentExecutions

@Stability(value=Experimental)
 @NotNull
public static Metric metricAllConcurrentExecutions(@Nullable
                                                                                            MetricOptions props)

(experimental) Metric for the number of concurrent executions across all Lambdas.

Default: max over 5 minutes

Parameters:

props -

metricAllConcurrentExecutions

@Stability(value=Experimental)
 @NotNull
public static Metric metricAllConcurrentExecutions()

(experimental) Metric for the number of concurrent executions across all Lambdas.

Default: max over 5 minutes

metricAllDuration

@Stability(value=Experimental)
 @NotNull
public static Metric metricAllDuration(@Nullable
                                                                                MetricOptions props)

(experimental) Metric for the Duration executing all Lambdas.

Default: average over 5 minutes

Parameters:

props -

metricAllDuration

@Stability(value=Experimental)
 @NotNull
public static Metric metricAllDuration()

(experimental) Metric for the Duration executing all Lambdas.

Default: average over 5 minutes

metricAllErrors

@Stability(value=Experimental)
 @NotNull
public static Metric metricAllErrors(@Nullable
                                                                              MetricOptions props)

(experimental) Metric for the number of Errors executing all Lambdas.

Default: sum over 5 minutes

Parameters:

props -

metricAllErrors

@Stability(value=Experimental)
 @NotNull
public static Metric metricAllErrors()

(experimental) Metric for the number of Errors executing all Lambdas.

Default: sum over 5 minutes

metricAllInvocations

@Stability(value=Experimental)
 @NotNull
public static Metric metricAllInvocations(@Nullable
                                                                                   MetricOptions props)

(experimental) Metric for the number of invocations of all Lambdas.

Default: sum over 5 minutes

Parameters:

props -

metricAllInvocations

@Stability(value=Experimental)
 @NotNull
public static Metric metricAllInvocations()

(experimental) Metric for the number of invocations of all Lambdas.

Default: sum over 5 minutes

metricAllThrottles

@Stability(value=Experimental)
 @NotNull
public static Metric metricAllThrottles(@Nullable
                                                                                 MetricOptions props)

(experimental) Metric for the number of throttled invocations of all Lambdas.

Default: sum over 5 minutes

Parameters:

props -

metricAllThrottles

@Stability(value=Experimental)
 @NotNull
public static Metric metricAllThrottles()

(experimental) Metric for the number of throttled invocations of all Lambdas.

Default: sum over 5 minutes

metricAllUnreservedConcurrentExecutions

@Stability(value=Experimental)
 @NotNull
public static Metric metricAllUnreservedConcurrentExecutions(@Nullable
                                                                                                      MetricOptions props)

(experimental) Metric for the number of unreserved concurrent executions across all Lambdas.

Default: max over 5 minutes

Parameters:

props -

metricAllUnreservedConcurrentExecutions

@Stability(value=Experimental)
 @NotNull
public static Metric metricAllUnreservedConcurrentExecutions()

(experimental) Metric for the number of unreserved concurrent executions across all Lambdas.

Default: max over 5 minutes

addEnvironment

@Stability(value=Experimental)
 @NotNull
public Function addEnvironment(@NotNull
                                                                        String key,
                                                                        @NotNull
                                                                        String value,
                                                                        @Nullable
                                                                        EnvironmentOptions options)

(experimental) Adds an environment variable to this Lambda function.

If this is a ref to a Lambda function, this operation results in a no-op.

Parameters:

key - The environment variable key. This parameter is required.

value - The environment variable's value. This parameter is required.

options - Environment variable options.

addEnvironment

@Stability(value=Experimental)
 @NotNull
public Function addEnvironment(@NotNull
                                                                        String key,
                                                                        @NotNull
                                                                        String value)

(experimental) Adds an environment variable to this Lambda function.

If this is a ref to a Lambda function, this operation results in a no-op.

Parameters:

key - The environment variable key. This parameter is required.

value - The environment variable's value. This parameter is required.

addLayers

@Stability(value=Experimental)
public void addLayers(@NotNull
                                                     ILayerVersion... layers)

(experimental) Adds one or more Lambda Layers to this Lambda function.

Parameters:

layers - the layers to be added. This parameter is required.

getCanCreatePermissions

@Stability(value=Experimental)
 @NotNull
protected Boolean getCanCreatePermissions()

(experimental) Whether the addPermission() call adds any permissions.

True for new Lambdas, false for version $LATEST and imported Lambdas from different accounts.

Specified by:

getCanCreatePermissions in class FunctionBase

getCurrentVersion

@Stability(value=Experimental)
 @NotNull
public Version getCurrentVersion()

(experimental) Returns a `lambda.Version` which represents the current version of this Lambda function. A new version will be created every time the function's configuration changes.

You can specify options for this version using the currentVersionOptions prop when initializing the lambda.Function.

getFunctionArn

@Stability(value=Experimental)
 @NotNull
public String getFunctionArn()

(experimental) ARN of this function.

Specified by:

getFunctionArn in interface IClientVpnConnectionHandler

Specified by:

getFunctionArn in interface IFunction

Specified by:

getFunctionArn in class FunctionBase

getFunctionName

@Stability(value=Experimental)
 @NotNull
public String getFunctionName()

(experimental) Name of this function.

Specified by:

getFunctionName in interface IClientVpnConnectionHandler

Specified by:

getFunctionName in interface IFunction

Specified by:

getFunctionName in class FunctionBase

getGrantPrincipal

@Stability(value=Experimental)
 @NotNull
public IPrincipal getGrantPrincipal()

(experimental) The principal this Lambda Function is running as.

Specified by:

getGrantPrincipal in interface IGrantable

Specified by:

getGrantPrincipal in class FunctionBase

getLogGroup

@Stability(value=Experimental)
 @NotNull
public ILogGroup getLogGroup()

(experimental) The LogGroup where the Lambda function's logs are made available.

If either logRetention is set or this property is called, a CloudFormation custom resource is added to the stack that pre-creates the log group as part of the stack deployment, if it already doesn't exist, and sets the correct log retention period (never expire, by default).

Further, if the log group already exists and the logRetention is not set, the custom resource will reset the log retention to never expire even if it was configured with a different value.

getPermissionsNode

@Stability(value=Experimental)
 @NotNull
public software.constructs.Node getPermissionsNode()

(experimental) The construct node where permissions are attached.

Specified by:

getPermissionsNode in interface IFunction

Specified by:

getPermissionsNode in class FunctionBase

getRuntime

@Stability(value=Experimental)
 @NotNull
public Runtime getRuntime()

(experimental) The runtime configured for this lambda.

getDeadLetterQueue

@Stability(value=Experimental)
 @Nullable
public IQueue getDeadLetterQueue()

(experimental) The DLQ associated with this Lambda Function (this is an optional attribute).

getRole

@Stability(value=Experimental)
 @Nullable
public IRole getRole()

(experimental) Execution role associated with this function.

Specified by:

getRole in interface IFunction

Specified by:

getRole in class FunctionBase