software.amazon.awscdk.services.lambda

Class FunctionRef

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.Construct

software.amazon.awscdk.services.lambda.FunctionRef

All Implemented Interfaces:

software.amazon.awscdk.services.events.IEventRuleTarget, software.amazon.awscdk.services.logs.ILogSubscriptionDestination, software.amazon.awscdk.services.s3.notifications.IBucketNotificationDestination, software.amazon.jsii.JsiiSerializable

Direct Known Subclasses:

Alias, Function, SingletonFunction

public abstract class FunctionRef
extends software.amazon.awscdk.Construct
implements software.amazon.awscdk.services.events.IEventRuleTarget, software.amazon.awscdk.services.logs.ILogSubscriptionDestination, software.amazon.awscdk.services.s3.notifications.IBucketNotificationDestination

Nested Class Summary

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.events.IEventRuleTarget

software.amazon.awscdk.services.events.IEventRuleTarget.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.logs.ILogSubscriptionDestination

software.amazon.awscdk.services.logs.ILogSubscriptionDestination.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.s3.notifications.IBucketNotificationDestination

software.amazon.awscdk.services.s3.notifications.IBucketNotificationDestination.Jsii$Proxy

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	FunctionRef(software.amazon.jsii.JsiiObject.InitializationMode mode)

Method Summary

Modifier and Type	Method and Description
void	addPermission(String id, Permission permission) Adds a permission to the Lambda resource policy.
void	addToRolePolicy(software.amazon.awscdk.PolicyStatement statement)
software.amazon.awscdk.services.s3.notifications.BucketNotificationDestinationProps	asBucketNotificationDestination(software.amazon.awscdk.Arn bucketArn, String bucketId) Allows this Lambda to be used as a destination for bucket notifications.
software.amazon.awscdk.services.events.EventRuleTargetProps	asEventRuleTarget(software.amazon.awscdk.services.events.RuleArn ruleArn, String ruleId) Returns a RuleTarget that can be used to trigger this Lambda as a result from a CloudWatch event.
FunctionRefProps	export() Export this Function (without the role)
protected Boolean	getCanCreatePermissions() Whether the addPermission() call adds any permissions True for new Lambdas, false for imported Lambdas (they might live in different accounts).
FunctionArn	getFunctionArn() The ARN fo the function.
FunctionName	getFunctionName() The name of the function.
software.amazon.awscdk.services.iam.Role	getRole() The IAM role associated with this function.
static FunctionRef	import_(software.amazon.awscdk.Construct parent, String name, FunctionRefProps ref) Creates a Lambda function object which represents a function not defined within this stack.
software.amazon.awscdk.services.logs.LogSubscriptionDestination	logSubscriptionDestination(software.amazon.awscdk.services.logs.LogGroup sourceLogGroup) Return the properties required to send subscription events to this destination.
software.amazon.awscdk.services.cloudwatch.Metric	metric(String metricName) Return the given named metric for this Lambda
software.amazon.awscdk.services.cloudwatch.Metric	metric(String metricName, software.amazon.awscdk.services.cloudwatch.MetricCustomization props) Return the given named metric for this Lambda
static software.amazon.awscdk.services.cloudwatch.Metric	metricAll(String metricName) Return the given named metric for this Lambda
static software.amazon.awscdk.services.cloudwatch.Metric	metricAll(String metricName, software.amazon.awscdk.services.cloudwatch.MetricCustomization props) Return the given named metric for this Lambda
static software.amazon.awscdk.services.cloudwatch.Metric	metricAllConcurrentExecutions() Metric for the number of concurrent executions across all Lambdas
static software.amazon.awscdk.services.cloudwatch.Metric	metricAllConcurrentExecutions(software.amazon.awscdk.services.cloudwatch.MetricCustomization props) Metric for the number of concurrent executions across all Lambdas
static software.amazon.awscdk.services.cloudwatch.Metric	metricAllDuration() Metric for the Duration executing all Lambdas
static software.amazon.awscdk.services.cloudwatch.Metric	metricAllDuration(software.amazon.awscdk.services.cloudwatch.MetricCustomization props) Metric for the Duration executing all Lambdas
static software.amazon.awscdk.services.cloudwatch.Metric	metricAllErrors() Metric for the number of Errors executing all Lambdas
static software.amazon.awscdk.services.cloudwatch.Metric	metricAllErrors(software.amazon.awscdk.services.cloudwatch.MetricCustomization props) Metric for the number of Errors executing all Lambdas
static software.amazon.awscdk.services.cloudwatch.Metric	metricAllInvocations() Metric for the number of invocations of all Lambdas
static software.amazon.awscdk.services.cloudwatch.Metric	metricAllInvocations(software.amazon.awscdk.services.cloudwatch.MetricCustomization props) Metric for the number of invocations of all Lambdas
static software.amazon.awscdk.services.cloudwatch.Metric	metricAllThrottles() Metric for the number of throttled invocations of all Lambdas
static software.amazon.awscdk.services.cloudwatch.Metric	metricAllThrottles(software.amazon.awscdk.services.cloudwatch.MetricCustomization props) Metric for the number of throttled invocations of all Lambdas
static software.amazon.awscdk.services.cloudwatch.Metric	metricAllUnreservedConcurrentExecutions() Metric for the number of unreserved concurrent executions across all Lambdas
static software.amazon.awscdk.services.cloudwatch.Metric	metricAllUnreservedConcurrentExecutions(software.amazon.awscdk.services.cloudwatch.MetricCustomization props) Metric for the number of unreserved concurrent executions across all Lambdas
software.amazon.awscdk.services.cloudwatch.Metric	metricDuration() Metric for the Duration of this Lambda
software.amazon.awscdk.services.cloudwatch.Metric	metricDuration(software.amazon.awscdk.services.cloudwatch.MetricCustomization props) Metric for the Duration of this Lambda
software.amazon.awscdk.services.cloudwatch.Metric	metricErrors() Metric for the Errors executing this Lambda
software.amazon.awscdk.services.cloudwatch.Metric	metricErrors(software.amazon.awscdk.services.cloudwatch.MetricCustomization props) Metric for the Errors executing this Lambda
software.amazon.awscdk.services.cloudwatch.Metric	metricInvocations() Metric for the number of invocations of this Lambda
software.amazon.awscdk.services.cloudwatch.Metric	metricInvocations(software.amazon.awscdk.services.cloudwatch.MetricCustomization props) Metric for the number of invocations of this Lambda
software.amazon.awscdk.services.cloudwatch.Metric	metricThrottles() Metric for the number of throttled invocations of this Lambda
software.amazon.awscdk.services.cloudwatch.Metric	metricThrottles(software.amazon.awscdk.services.cloudwatch.MetricCustomization props) Metric for the number of throttled invocations of this Lambda

Methods inherited from class software.amazon.awscdk.Construct

addChild, addError, addInfo, addMetadata, addMetadata, addWarning, ancestors, ancestors, findChild, getChildren, getContext, getId, getMetadata, getParent, getPath, getUniqueId, lock, requireContext, required, setContext, toString, toTreeString, toTreeString, tryFindChild, unlock, validate, validateTree

Methods inherited from class software.amazon.jsii.JsiiObject

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

Methods inherited from class java.lang.Object

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

Constructor Detail

FunctionRef

protected FunctionRef(software.amazon.jsii.JsiiObject.InitializationMode mode)

Method Detail

import_

public static FunctionRef import_(software.amazon.awscdk.Construct parent,
                                  String name,
                                  FunctionRefProps ref)

Creates a Lambda function object which represents a function not defined within this stack. Lambda.import(this, 'MyImportedFunction', { lambdaArn: new LambdaArn('arn:aws:...') });

Parameters:

parent - The parent construct

name - The name of the lambda construct

ref - A reference to a Lambda function. Can be created manually (see example above) or obtained through a call to `lambda.export()`.

metricAll

public static software.amazon.awscdk.services.cloudwatch.Metric metricAll(String metricName,
                                                                          @Nullable
                                                                          software.amazon.awscdk.services.cloudwatch.MetricCustomization props)

Return the given named metric for this Lambda

metricAll

public static software.amazon.awscdk.services.cloudwatch.Metric metricAll(String metricName)

Return the given named metric for this Lambda

metricAllErrors

public static software.amazon.awscdk.services.cloudwatch.Metric metricAllErrors(@Nullable
                                                                                software.amazon.awscdk.services.cloudwatch.MetricCustomization props)

Metric for the number of Errors executing all Lambdas

metricAllErrors

public static software.amazon.awscdk.services.cloudwatch.Metric metricAllErrors()

Metric for the number of Errors executing all Lambdas

metricAllDuration

public static software.amazon.awscdk.services.cloudwatch.Metric metricAllDuration(@Nullable
                                                                                  software.amazon.awscdk.services.cloudwatch.MetricCustomization props)

Metric for the Duration executing all Lambdas

metricAllDuration

public static software.amazon.awscdk.services.cloudwatch.Metric metricAllDuration()

Metric for the Duration executing all Lambdas

metricAllInvocations

public static software.amazon.awscdk.services.cloudwatch.Metric metricAllInvocations(@Nullable
                                                                                     software.amazon.awscdk.services.cloudwatch.MetricCustomization props)

Metric for the number of invocations of all Lambdas

metricAllInvocations

public static software.amazon.awscdk.services.cloudwatch.Metric metricAllInvocations()

Metric for the number of invocations of all Lambdas

metricAllThrottles

public static software.amazon.awscdk.services.cloudwatch.Metric metricAllThrottles(@Nullable
                                                                                   software.amazon.awscdk.services.cloudwatch.MetricCustomization props)

Metric for the number of throttled invocations of all Lambdas

metricAllThrottles

public static software.amazon.awscdk.services.cloudwatch.Metric metricAllThrottles()

Metric for the number of throttled invocations of all Lambdas

metricAllConcurrentExecutions

public static software.amazon.awscdk.services.cloudwatch.Metric metricAllConcurrentExecutions(@Nullable
                                                                                              software.amazon.awscdk.services.cloudwatch.MetricCustomization props)

Metric for the number of concurrent executions across all Lambdas

metricAllConcurrentExecutions

public static software.amazon.awscdk.services.cloudwatch.Metric metricAllConcurrentExecutions()

Metric for the number of concurrent executions across all Lambdas

metricAllUnreservedConcurrentExecutions

public static software.amazon.awscdk.services.cloudwatch.Metric metricAllUnreservedConcurrentExecutions(@Nullable
                                                                                                        software.amazon.awscdk.services.cloudwatch.MetricCustomization props)

Metric for the number of unreserved concurrent executions across all Lambdas

metricAllUnreservedConcurrentExecutions

public static software.amazon.awscdk.services.cloudwatch.Metric metricAllUnreservedConcurrentExecutions()

Metric for the number of unreserved concurrent executions across all Lambdas

addPermission

public void addPermission(String id,
                          Permission permission)

Adds a permission to the Lambda resource policy.

Parameters:

id - The id ƒor the permission construct

addToRolePolicy

public void addToRolePolicy(software.amazon.awscdk.PolicyStatement statement)

asEventRuleTarget

public software.amazon.awscdk.services.events.EventRuleTargetProps asEventRuleTarget(software.amazon.awscdk.services.events.RuleArn ruleArn,
                                                                                     String ruleId)

Returns a RuleTarget that can be used to trigger this Lambda as a result from a CloudWatch event.

Specified by:

asEventRuleTarget in interface software.amazon.awscdk.services.events.IEventRuleTarget

metric

public software.amazon.awscdk.services.cloudwatch.Metric metric(String metricName,
                                                                @Nullable
                                                                software.amazon.awscdk.services.cloudwatch.MetricCustomization props)

Return the given named metric for this Lambda

metric

public software.amazon.awscdk.services.cloudwatch.Metric metric(String metricName)

Return the given named metric for this Lambda

metricErrors

public software.amazon.awscdk.services.cloudwatch.Metric metricErrors(@Nullable
                                                                      software.amazon.awscdk.services.cloudwatch.MetricCustomization props)

Metric for the Errors executing this Lambda

metricErrors

public software.amazon.awscdk.services.cloudwatch.Metric metricErrors()

Metric for the Errors executing this Lambda

metricDuration

public software.amazon.awscdk.services.cloudwatch.Metric metricDuration(@Nullable
                                                                        software.amazon.awscdk.services.cloudwatch.MetricCustomization props)

Metric for the Duration of this Lambda

metricDuration

public software.amazon.awscdk.services.cloudwatch.Metric metricDuration()

Metric for the Duration of this Lambda

metricInvocations

public software.amazon.awscdk.services.cloudwatch.Metric metricInvocations(@Nullable
                                                                           software.amazon.awscdk.services.cloudwatch.MetricCustomization props)

Metric for the number of invocations of this Lambda

metricInvocations

public software.amazon.awscdk.services.cloudwatch.Metric metricInvocations()

Metric for the number of invocations of this Lambda

metricThrottles

public software.amazon.awscdk.services.cloudwatch.Metric metricThrottles(@Nullable
                                                                         software.amazon.awscdk.services.cloudwatch.MetricCustomization props)

Metric for the number of throttled invocations of this Lambda

metricThrottles

public software.amazon.awscdk.services.cloudwatch.Metric metricThrottles()

Metric for the number of throttled invocations of this Lambda

logSubscriptionDestination

public software.amazon.awscdk.services.logs.LogSubscriptionDestination logSubscriptionDestination(software.amazon.awscdk.services.logs.LogGroup sourceLogGroup)

Return the properties required to send subscription events to this destination. If necessary, the destination can use the properties of the SubscriptionFilter object itself to configure its permissions to allow the subscription to write to it. The destination may reconfigure its own permissions in response to this function call.

Specified by:

logSubscriptionDestination in interface software.amazon.awscdk.services.logs.ILogSubscriptionDestination

export

public FunctionRefProps export()

Export this Function (without the role)

asBucketNotificationDestination

public software.amazon.awscdk.services.s3.notifications.BucketNotificationDestinationProps asBucketNotificationDestination(software.amazon.awscdk.Arn bucketArn,
                                                                                                                           String bucketId)

Allows this Lambda to be used as a destination for bucket notifications. Use `bucket.onEvent(lambda)` to subscribe.

Specified by:

asBucketNotificationDestination in interface software.amazon.awscdk.services.s3.notifications.IBucketNotificationDestination

getFunctionName

public FunctionName getFunctionName()

The name of the function.

getFunctionArn

public FunctionArn getFunctionArn()

The ARN fo the function.

getRole

@Nullable
public software.amazon.awscdk.services.iam.Role getRole()

The IAM role associated with this function.

getCanCreatePermissions

protected Boolean getCanCreatePermissions()

Whether the addPermission() call adds any permissions True for new Lambdas, false for imported Lambdas (they might live in different accounts).