Documentation
¶
Index ¶
- func EdgeFunction_IsConstruct(x interface{}) *bool
- func EdgeFunction_IsOwnedResource(construct constructs.IConstruct) *bool
- func EdgeFunction_IsResource(construct constructs.IConstruct) *bool
- func EdgeFunction_PROPERTY_INJECTION_ID() *string
- func NewEdgeFunction_Override(e EdgeFunction, scope constructs.Construct, id *string, ...)
- type EdgeFunction
- type EdgeFunctionProps
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func EdgeFunction_IsConstruct ¶
func EdgeFunction_IsConstruct(x interface{}) *bool
Checks if `x` is a construct.
Use this method instead of `instanceof` to properly detect `Construct` instances, even when the construct library is symlinked.
Explanation: in JavaScript, multiple copies of the `constructs` library on disk are seen as independent, completely different libraries. As a consequence, the class `Construct` in each copy of the `constructs` library is seen as a different class, and an instance of one class will not test as `instanceof` the other class. `npm install` will not create installations like this, but users may manually symlink construct libraries together or use a monorepo tool: in those cases, multiple copies of the `constructs` library can be accidentally installed, and `instanceof` will behave unpredictably. It is safest to avoid using `instanceof`, and using this type-testing method instead.
Returns: true if `x` is an object created from a class which extends `Construct`.
func EdgeFunction_IsOwnedResource ¶ added in v2.32.0
func EdgeFunction_IsOwnedResource(construct constructs.IConstruct) *bool
Returns true if the construct was created by CDK, and false otherwise.
func EdgeFunction_IsResource ¶
func EdgeFunction_IsResource(construct constructs.IConstruct) *bool
Check whether the given construct is a Resource.
func EdgeFunction_PROPERTY_INJECTION_ID ¶ added in v2.196.0
func EdgeFunction_PROPERTY_INJECTION_ID() *string
func NewEdgeFunction_Override ¶
func NewEdgeFunction_Override(e EdgeFunction, scope constructs.Construct, id *string, props *EdgeFunctionProps)
Types ¶
type EdgeFunction ¶
type EdgeFunction interface {
awscdk.Resource
awslambda.IVersion
// The system architectures compatible with this lambda function.
Architecture() awslambda.Architecture
// Not supported.
//
// Connections are only applicable to VPC-enabled functions.
Connections() awsec2.Connections
// Convenience method to make `EdgeFunction` conform to the same interface as `Function`.
CurrentVersion() awslambda.IVersion
// The ARN of the version for Lambda@Edge.
EdgeArn() *string
// The environment this resource belongs to.
//
// For resources that are created and managed in a Stack (those created by
// creating new class instances like `new Role()`, `new Bucket()`, etc.), this
// is always the same as the environment of the stack they belong to.
//
// For referenced resources (those obtained from referencing methods like
// `Role.fromRoleArn()`, `Bucket.fromBucketName()`, etc.), they might be
// different than the stack they were imported into.
Env() *interfaces.ResourceEnvironment
// The ARN of the function.
FunctionArn() *string
// The name of the function.
FunctionName() *string
// A reference to a Function resource.
FunctionRef() *interfacesawslambda.FunctionReference
// The principal to grant permissions to.
GrantPrincipal() awsiam.IPrincipal
// Whether or not this Lambda function was bound to a VPC.
//
// If this is is `false`, trying to access the `connections` object will fail.
IsBoundToVpc() *bool
// The underlying AWS Lambda function.
Lambda() awslambda.IFunction
// The `$LATEST` version of this function.
//
// Note that this is reference to a non-specific AWS Lambda version, which
// means the function this version refers to can return different results in
// different invocations.
//
// To obtain a reference to an explicit version which references the current
// function configuration, use `lambdaFunction.currentVersion` instead.
LatestVersion() awslambda.IVersion
// The tree node.
Node() constructs.Node
// The construct node where permissions are attached.
PermissionsNode() constructs.Node
// Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.
//
// This value will resolve to one of the following:
// - a concrete value (e.g. `"my-awesome-bucket"`)
// - `undefined`, when a name should be generated by CloudFormation
// - a concrete name generated automatically during synthesis, in
// cross-environment scenarios.
PhysicalName() *string
// The ARN(s) to put into the resource field of the generated IAM policy for grantInvoke().
//
// This property is for cdk modules to consume only. You should not need to use this property.
// Instead, use grantInvoke() directly.
ResourceArnsForGrantInvoke() *[]*string
// The IAM role associated with this function.
Role() awsiam.IRole
// The stack in which this resource is defined.
Stack() awscdk.Stack
// The most recently deployed version of this function.
Version() *string
// A reference to a Version resource.
VersionRef() *interfacesawslambda.VersionReference
// Defines an alias for this version.
AddAlias(aliasName *string, options *awslambda.AliasOptions) awslambda.Alias
// Adds an event source to this function.
AddEventSource(source awslambda.IEventSource)
// Adds an event source that maps to this AWS Lambda function.
AddEventSourceMapping(id *string, options *awslambda.EventSourceMappingOptions) awslambda.EventSourceMapping
// Adds a url to this lambda function.
AddFunctionUrl(options *awslambda.FunctionUrlOptions) awslambda.FunctionUrl
// Adds a permission to the Lambda resource policy.
AddPermission(id *string, permission *awslambda.Permission)
// Adds a statement to the IAM role assumed by the instance.
AddToRolePolicy(statement awsiam.PolicyStatement)
// Apply the given removal policy to this resource.
//
// The Removal Policy controls what happens to this resource when it stops
// being managed by CloudFormation, either because you've removed it from the
// CDK application or because you've made a change that requires the resource
// to be replaced.
//
// The resource can be deleted (`RemovalPolicy.DESTROY`), or left in your AWS
// account for data recovery and cleanup later (`RemovalPolicy.RETAIN`).
ApplyRemovalPolicy(policy awscdk.RemovalPolicy)
// Configures options for asynchronous invocation.
ConfigureAsyncInvoke(options *awslambda.EventInvokeConfigOptions)
GeneratePhysicalName() *string
// Returns an environment-sensitive token that should be used for the resource's "ARN" attribute (e.g. `bucket.bucketArn`).
//
// Normally, this token will resolve to `arnAttr`, but if the resource is
// referenced across environments, `arnComponents` will be used to synthesize
// a concrete ARN with the resource's physical name. Make sure to reference
// `this.physicalName` in `arnComponents`.
GetResourceArnAttribute(arnAttr *string, arnComponents *awscdk.ArnComponents) *string
// Returns an environment-sensitive token that should be used for the resource's "name" attribute (e.g. `bucket.bucketName`).
//
// Normally, this token will resolve to `nameAttr`, but if the resource is
// referenced across environments, it will be resolved to `this.physicalName`,
// which will be a concrete name.
GetResourceNameAttribute(nameAttr *string) *string
// Grant the given identity permissions to invoke this Lambda.
GrantInvoke(identity awsiam.IGrantable) awsiam.Grant
// Grant multiple principals the ability to invoke this Lambda via CompositePrincipal.
GrantInvokeCompositePrincipal(compositePrincipal awsiam.CompositePrincipal) *[]awsiam.Grant
// Grant the given identity permissions to invoke the $LATEST version or unqualified version of this Lambda.
GrantInvokeLatestVersion(identity awsiam.IGrantable) awsiam.Grant
// Grant the given identity permissions to invoke this Lambda Function URL.
GrantInvokeUrl(identity awsiam.IGrantable) awsiam.Grant
// Grant the given identity permissions to invoke the given version of this Lambda.
GrantInvokeVersion(identity awsiam.IGrantable, version awslambda.IVersion) awsiam.Grant
// Return the given named metric for this Lambda Return the given named metric for this Function.
Metric(metricName *string, props *awscloudwatch.MetricOptions) awscloudwatch.Metric
// Metric for the Duration of this Lambda How long execution of this Lambda takes.
//
// Average over 5 minutes.
MetricDuration(props *awscloudwatch.MetricOptions) awscloudwatch.Metric
// How many invocations of this Lambda fail.
//
// Sum over 5 minutes.
MetricErrors(props *awscloudwatch.MetricOptions) awscloudwatch.Metric
// Metric for the number of invocations of this Lambda How often this Lambda is invoked.
//
// Sum over 5 minutes.
MetricInvocations(props *awscloudwatch.MetricOptions) awscloudwatch.Metric
// Metric for the number of throttled invocations of this Lambda How often this Lambda is throttled.
//
// Sum over 5 minutes.
MetricThrottles(props *awscloudwatch.MetricOptions) awscloudwatch.Metric
// Returns a string representation of this construct.
ToString() *string
}
A Lambda@Edge function.
Convenience resource for requesting a Lambda function in the 'us-east-1' region for use with Lambda@Edge. Implements several restrictions enforced by Lambda@Edge.
Note that this construct requires that the 'us-east-1' region has been bootstrapped. See https://docs.aws.amazon.com/cdk/latest/guide/bootstrapping.html or 'cdk bootstrap --help' for options.
Example:
var myBucket Bucket
// A Lambda@Edge function added to default behavior of a Distribution
// and triggered on every request
myFunc := experimental.NewEdgeFunction(this, jsii.String("MyFunction"), &EdgeFunctionProps{
Runtime: lambda.Runtime_NODEJS_LATEST(),
Handler: jsii.String("index.handler"),
Code: lambda.Code_FromAsset(path.join(__dirname, jsii.String("lambda-handler"))),
})
cloudfront.NewDistribution(this, jsii.String("myDist"), &DistributionProps{
DefaultBehavior: &BehaviorOptions{
Origin: origins.NewS3Origin(myBucket),
EdgeLambdas: []EdgeLambda{
&EdgeLambda{
FunctionVersion: myFunc.currentVersion,
EventType: cloudfront.LambdaEdgeEventType_VIEWER_REQUEST,
},
},
},
})
func NewEdgeFunction ¶
func NewEdgeFunction(scope constructs.Construct, id *string, props *EdgeFunctionProps) EdgeFunction
type EdgeFunctionProps ¶
type EdgeFunctionProps struct {
// The maximum age of a request that Lambda sends to a function for processing.
//
// Minimum: 60 seconds
// Maximum: 6 hours.
// Default: Duration.hours(6)
//
MaxEventAge awscdk.Duration `field:"optional" json:"maxEventAge" yaml:"maxEventAge"`
// The destination for failed invocations.
// Default: - no destination.
//
OnFailure awslambda.IDestination `field:"optional" json:"onFailure" yaml:"onFailure"`
// The destination for successful invocations.
// Default: - no destination.
//
OnSuccess awslambda.IDestination `field:"optional" json:"onSuccess" yaml:"onSuccess"`
// The maximum number of times to retry when the function returns an error.
//
// Minimum: 0
// Maximum: 2.
// Default: 2.
//
RetryAttempts *float64 `field:"optional" json:"retryAttempts" yaml:"retryAttempts"`
// Specify the configuration of AWS Distro for OpenTelemetry (ADOT) instrumentation.
// See: https://aws-otel.github.io/docs/getting-started/lambda
//
// Default: - No ADOT instrumentation.
//
AdotInstrumentation *awslambda.AdotInstrumentationConfig `field:"optional" json:"adotInstrumentation" yaml:"adotInstrumentation"`
// Whether to allow the Lambda to send all ipv6 network traffic.
//
// If set to true, there will only be a single egress rule which allows all
// outbound ipv6 traffic. If set to false, you must individually add traffic rules to allow the
// Lambda to connect to network targets using ipv6.
//
// Do not specify this property if the `securityGroups` or `securityGroup` property is set.
// Instead, configure `allowAllIpv6Outbound` directly on the security group.
// Default: false.
//
AllowAllIpv6Outbound *bool `field:"optional" json:"allowAllIpv6Outbound" yaml:"allowAllIpv6Outbound"`
// Whether to allow the Lambda to send all network traffic (except ipv6).
//
// If set to false, you must individually add traffic rules to allow the
// Lambda to connect to network targets.
//
// Do not specify this property if the `securityGroups` or `securityGroup` property is set.
// Instead, configure `allowAllOutbound` directly on the security group.
// Default: true.
//
AllowAllOutbound *bool `field:"optional" json:"allowAllOutbound" yaml:"allowAllOutbound"`
// Lambda Functions in a public subnet can NOT access the internet.
//
// Use this property to acknowledge this limitation and still place the function in a public subnet.
// See: https://stackoverflow.com/questions/52992085/why-cant-an-aws-lambda-function-inside-a-public-subnet-in-a-vpc-connect-to-the/52994841#52994841
//
// Default: false.
//
AllowPublicSubnet *bool `field:"optional" json:"allowPublicSubnet" yaml:"allowPublicSubnet"`
// Sets the application log level for the function.
// Default: "INFO".
//
// Deprecated: Use `applicationLogLevelV2` as a property instead.
ApplicationLogLevel *string `field:"optional" json:"applicationLogLevel" yaml:"applicationLogLevel"`
// Sets the application log level for the function.
// Default: ApplicationLogLevel.INFO
//
ApplicationLogLevelV2 awslambda.ApplicationLogLevel `field:"optional" json:"applicationLogLevelV2" yaml:"applicationLogLevelV2"`
// The system architectures compatible with this lambda function.
// Default: Architecture.X86_64
//
Architecture awslambda.Architecture `field:"optional" json:"architecture" yaml:"architecture"`
// Code signing config associated with this function.
// Default: - Not Sign the Code.
//
CodeSigningConfig interfacesawslambda.ICodeSigningConfigRef `field:"optional" json:"codeSigningConfig" yaml:"codeSigningConfig"`
// Options for the `lambda.Version` resource automatically created by the `fn.currentVersion` method.
// Default: - default options as described in `VersionOptions`.
//
CurrentVersionOptions *awslambda.VersionOptions `field:"optional" json:"currentVersionOptions" yaml:"currentVersionOptions"`
// The SQS queue to use if DLQ is enabled.
//
// If SNS topic is desired, specify `deadLetterTopic` property instead.
// Default: - SQS queue with 14 day retention period if `deadLetterQueueEnabled` is `true`.
//
DeadLetterQueue awssqs.IQueue `field:"optional" json:"deadLetterQueue" yaml:"deadLetterQueue"`
// Enabled DLQ.
//
// If `deadLetterQueue` is undefined,
// an SQS queue with default options will be defined for your Function.
// Default: - false unless `deadLetterQueue` is set, which implies DLQ is enabled.
//
DeadLetterQueueEnabled *bool `field:"optional" json:"deadLetterQueueEnabled" yaml:"deadLetterQueueEnabled"`
// The SNS topic to use as a DLQ.
//
// Note that if `deadLetterQueueEnabled` is set to `true`, an SQS queue will be created
// rather than an SNS topic. Using an SNS topic as a DLQ requires this property to be set explicitly.
// Default: - no SNS topic.
//
DeadLetterTopic awssns.ITopic `field:"optional" json:"deadLetterTopic" yaml:"deadLetterTopic"`
// A description of the function.
// Default: - No description.
//
Description *string `field:"optional" json:"description" yaml:"description"`
// Key-value pairs that Lambda caches and makes available for your Lambda functions.
//
// Use environment variables to apply configuration changes, such
// as test and production environment configurations, without changing your
// Lambda function source code.
// Default: - No environment variables.
//
Environment *map[string]*string `field:"optional" json:"environment" yaml:"environment"`
// The AWS KMS key that's used to encrypt your function's environment variables.
// Default: - AWS Lambda creates and uses an AWS managed customer master key (CMK).
//
EnvironmentEncryption interfacesawskms.IKeyRef `field:"optional" json:"environmentEncryption" yaml:"environmentEncryption"`
// The size of the function’s /tmp directory in MiB.
// Default: 512 MiB.
//
EphemeralStorageSize awscdk.Size `field:"optional" json:"ephemeralStorageSize" yaml:"ephemeralStorageSize"`
// Event sources for this function.
//
// You can also add event sources using `addEventSource`.
// Default: - No event sources.
//
Events *[]awslambda.IEventSource `field:"optional" json:"events" yaml:"events"`
// The filesystem configuration for the lambda function.
// Default: - will not mount any filesystem.
//
Filesystem awslambda.FileSystem `field:"optional" json:"filesystem" yaml:"filesystem"`
// A name for the function.
// Default: - AWS CloudFormation generates a unique physical ID and uses that
// ID for the function's name. For more information, see Name Type.
//
FunctionName *string `field:"optional" json:"functionName" yaml:"functionName"`
// Initial policy statements to add to the created Lambda Role.
//
// You can call `addToRolePolicy` to the created lambda to add statements post creation.
// Default: - No policy statements are added to the created Lambda role.
//
InitialPolicy *[]awsiam.PolicyStatement `field:"optional" json:"initialPolicy" yaml:"initialPolicy"`
// Specify the version of CloudWatch Lambda insights to use for monitoring.
// See: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Lambda-Insights-Getting-Started-docker.html
//
// Default: - No Lambda Insights.
//
InsightsVersion awslambda.LambdaInsightsVersion `field:"optional" json:"insightsVersion" yaml:"insightsVersion"`
// Allows outbound IPv6 traffic on VPC functions that are connected to dual-stack subnets.
//
// Only used if 'vpc' is supplied.
// Default: false.
//
Ipv6AllowedForDualStack *bool `field:"optional" json:"ipv6AllowedForDualStack" yaml:"ipv6AllowedForDualStack"`
// A list of layers to add to the function's execution environment.
//
// You can configure your Lambda function to pull in
// additional code during initialization in the form of layers. Layers are packages of libraries or other dependencies
// that can be used by multiple functions.
// Default: - No layers.
//
Layers *[]awslambda.ILayerVersion `field:"optional" json:"layers" yaml:"layers"`
// Sets the logFormat for the function.
// Default: "Text".
//
// Deprecated: Use `loggingFormat` as a property instead.
LogFormat *string `field:"optional" json:"logFormat" yaml:"logFormat"`
// Sets the loggingFormat for the function.
// Default: LoggingFormat.TEXT
//
LoggingFormat awslambda.LoggingFormat `field:"optional" json:"loggingFormat" yaml:"loggingFormat"`
// The log group the function sends logs to.
//
// By default, Lambda functions send logs to an automatically created default log group named /aws/lambda/\<function name\>.
// However you cannot change the properties of this auto-created log group using the AWS CDK, e.g. you cannot set a different log retention.
//
// Use the `logGroup` property to create a fully customizable LogGroup ahead of time, and instruct the Lambda function to send logs to it.
//
// Providing a user-controlled log group was rolled out to commercial regions on 2023-11-16.
// If you are deploying to another type of region, please check regional availability first.
// Default: `/aws/lambda/${this.functionName}` - default log group created by Lambda
//
LogGroup awslogs.ILogGroup `field:"optional" json:"logGroup" yaml:"logGroup"`
// Determine the removal policy of the log group that is auto-created by this construct.
//
// Normally you want to retain the log group so you can diagnose issues
// from logs even after a deployment that no longer includes the log group.
// In that case, use the normal date-based retention policy to age out your
// logs.
// Default: RemovalPolicy.Retain
//
// Deprecated: use `logGroup` instead.
LogRemovalPolicy awscdk.RemovalPolicy `field:"optional" json:"logRemovalPolicy" yaml:"logRemovalPolicy"`
// The number of days log events are kept in CloudWatch Logs.
//
// When updating
// this property, unsetting it doesn't remove the log retention policy. To
// remove the retention policy, set the value to `INFINITE`.
//
// This is a legacy API and we strongly recommend you move away from it if you can.
// Instead create a fully customizable log group with `logs.LogGroup` and use the `logGroup` property
// to instruct the Lambda function to send logs to it.
// Migrating from `logRetention` to `logGroup` will cause the name of the log group to change.
// Users and code and referencing the name verbatim will have to adjust.
//
// In AWS CDK code, you can access the log group name directly from the LogGroup construct:
// “`ts
// import * as logs from 'aws-cdk-lib/aws-logs';
//
// declare const myLogGroup: logs.LogGroup;
// myLogGroup.logGroupName;
// “`.
// Default: logs.RetentionDays.INFINITE
//
// Deprecated: use `logGroup` instead.
LogRetention awslogs.RetentionDays `field:"optional" json:"logRetention" yaml:"logRetention"`
// When log retention is specified, a custom resource attempts to create the CloudWatch log group.
//
// These options control the retry policy when interacting with CloudWatch APIs.
//
// This is a legacy API and we strongly recommend you migrate to `logGroup` if you can.
// `logGroup` allows you to create a fully customizable log group and instruct the Lambda function to send logs to it.
// Default: - Default AWS SDK retry options.
//
LogRetentionRetryOptions *awslambda.LogRetentionRetryOptions `field:"optional" json:"logRetentionRetryOptions" yaml:"logRetentionRetryOptions"`
// The IAM role for the Lambda function associated with the custom resource that sets the retention policy.
//
// This is a legacy API and we strongly recommend you migrate to `logGroup` if you can.
// `logGroup` allows you to create a fully customizable log group and instruct the Lambda function to send logs to it.
// Default: - A new role is created.
//
LogRetentionRole awsiam.IRole `field:"optional" json:"logRetentionRole" yaml:"logRetentionRole"`
// The amount of memory, in MB, that is allocated to your Lambda function.
//
// Lambda uses this value to proportionally allocate the amount of CPU
// power. For more information, see Resource Model in the AWS Lambda
// Developer Guide.
// Default: 128.
//
MemorySize *float64 `field:"optional" json:"memorySize" yaml:"memorySize"`
// Specify the configuration of Parameters and Secrets Extension.
// See: https://docs.aws.amazon.com/systems-manager/latest/userguide/ps-integration-lambda-extensions.html
//
// Default: - No Parameters and Secrets Extension.
//
ParamsAndSecrets awslambda.ParamsAndSecretsLayerVersion `field:"optional" json:"paramsAndSecrets" yaml:"paramsAndSecrets"`
// Enable profiling.
// See: https://docs.aws.amazon.com/codeguru/latest/profiler-ug/setting-up-lambda.html
//
// Default: - No profiling.
//
Profiling *bool `field:"optional" json:"profiling" yaml:"profiling"`
// Profiling Group.
// See: https://docs.aws.amazon.com/codeguru/latest/profiler-ug/setting-up-lambda.html
//
// Default: - A new profiling group will be created if `profiling` is set.
//
ProfilingGroup awscodeguruprofiler.IProfilingGroup `field:"optional" json:"profilingGroup" yaml:"profilingGroup"`
// Sets the Recursive Loop Protection for Lambda Function.
//
// It lets Lambda detect and terminate unintended recursive loops.
// Default: RecursiveLoop.Terminate
//
RecursiveLoop awslambda.RecursiveLoop `field:"optional" json:"recursiveLoop" yaml:"recursiveLoop"`
// The maximum of concurrent executions you want to reserve for the function.
// See: https://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html
//
// Default: - No specific limit - account limit.
//
ReservedConcurrentExecutions *float64 `field:"optional" json:"reservedConcurrentExecutions" yaml:"reservedConcurrentExecutions"`
// Lambda execution role.
//
// This is the role that will be assumed by the function upon execution.
// It controls the permissions that the function will have. The Role must
// be assumable by the 'lambda.amazonaws.com' service principal.
//
// The default Role automatically has permissions granted for Lambda execution. If you
// provide a Role, you must add the relevant AWS managed policies yourself.
//
// The relevant managed policies are "service-role/AWSLambdaBasicExecutionRole" and
// "service-role/AWSLambdaVPCAccessExecutionRole".
// Default: - A unique role will be generated for this lambda function.
// Both supplied and generated roles can always be changed by calling `addToRolePolicy`.
//
Role awsiam.IRole `field:"optional" json:"role" yaml:"role"`
// Sets the runtime management configuration for a function's version.
// Default: Auto.
//
RuntimeManagementMode awslambda.RuntimeManagementMode `field:"optional" json:"runtimeManagementMode" yaml:"runtimeManagementMode"`
// The list of security groups to associate with the Lambda's network interfaces.
//
// Only used if 'vpc' is supplied.
// Default: - If the function is placed within a VPC and a security group is
// not specified, either by this or securityGroup prop, a dedicated security
// group will be created for this function.
//
SecurityGroups *[]awsec2.ISecurityGroup `field:"optional" json:"securityGroups" yaml:"securityGroups"`
// Enable SnapStart for Lambda Function.
//
// SnapStart is currently supported for Java 11, Java 17, Python 3.12, Python 3.13, and .NET 8 runtime
// Default: - No snapstart.
//
SnapStart awslambda.SnapStartConf `field:"optional" json:"snapStart" yaml:"snapStart"`
// Sets the system log level for the function.
// Default: "INFO".
//
// Deprecated: Use `systemLogLevelV2` as a property instead.
SystemLogLevel *string `field:"optional" json:"systemLogLevel" yaml:"systemLogLevel"`
// Sets the system log level for the function.
// Default: SystemLogLevel.INFO
//
SystemLogLevelV2 awslambda.SystemLogLevel `field:"optional" json:"systemLogLevelV2" yaml:"systemLogLevelV2"`
// The tenancy configuration for the function.
// Default: - Tenant isolation is not enabled.
//
TenancyConfig awslambda.TenancyConfig `field:"optional" json:"tenancyConfig" yaml:"tenancyConfig"`
// The function execution time (in seconds) after which Lambda terminates the function.
//
// Because the execution time affects cost, set this value
// based on the function's expected execution time.
// Default: Duration.seconds(3)
//
Timeout awscdk.Duration `field:"optional" json:"timeout" yaml:"timeout"`
// Enable AWS X-Ray Tracing for Lambda Function.
// Default: Tracing.Disabled
//
Tracing awslambda.Tracing `field:"optional" json:"tracing" yaml:"tracing"`
// VPC network to place Lambda network interfaces.
//
// Specify this if the Lambda function needs to access resources in a VPC.
// This is required when `vpcSubnets` is specified.
// Default: - Function is not placed within a VPC.
//
Vpc awsec2.IVpc `field:"optional" json:"vpc" yaml:"vpc"`
// Where to place the network interfaces within the VPC.
//
// This requires `vpc` to be specified in order for interfaces to actually be
// placed in the subnets. If `vpc` is not specify, this will raise an error.
//
// Note: Internet access for Lambda Functions requires a NAT Gateway, so picking
// public subnets is not allowed (unless `allowPublicSubnet` is set to `true`).
// Default: - the Vpc default strategy if not specified.
//
VpcSubnets *awsec2.SubnetSelection `field:"optional" json:"vpcSubnets" yaml:"vpcSubnets"`
// The source code of your Lambda function.
//
// You can point to a file in an
// Amazon Simple Storage Service (Amazon S3) bucket or specify your source
// code as inline text.
Code awslambda.Code `field:"required" json:"code" yaml:"code"`
// The name of the method within your code that Lambda calls to execute your function.
//
// The format includes the file name. It can also include
// namespaces and other qualifiers, depending on the runtime.
// For more information, see https://docs.aws.amazon.com/lambda/latest/dg/foundation-progmodel.html.
//
// Use `Handler.FROM_IMAGE` when defining a function from a Docker image.
//
// NOTE: If you specify your source code as inline text by specifying the
// ZipFile property within the Code property, specify index.function_name as
// the handler.
Handler *string `field:"required" json:"handler" yaml:"handler"`
// The runtime environment for the Lambda function that you are uploading.
//
// For valid values, see the Runtime property in the AWS Lambda Developer
// Guide.
//
// Use `Runtime.FROM_IMAGE` when defining a function from a Docker image.
Runtime awslambda.Runtime `field:"required" json:"runtime" yaml:"runtime"`
// The stack ID of Lambda@Edge function.
// Default: - `edge-lambda-stack-${region}`.
//
StackId *string `field:"optional" json:"stackId" yaml:"stackId"`
}
Properties for creating a Lambda@Edge function.
Example:
var myBucket Bucket
// A Lambda@Edge function added to default behavior of a Distribution
// and triggered on every request
myFunc := experimental.NewEdgeFunction(this, jsii.String("MyFunction"), &EdgeFunctionProps{
Runtime: lambda.Runtime_NODEJS_LATEST(),
Handler: jsii.String("index.handler"),
Code: lambda.Code_FromAsset(path.join(__dirname, jsii.String("lambda-handler"))),
})
cloudfront.NewDistribution(this, jsii.String("myDist"), &DistributionProps{
DefaultBehavior: &BehaviorOptions{
Origin: origins.NewS3Origin(myBucket),
EdgeLambdas: []EdgeLambda{
&EdgeLambda{
FunctionVersion: myFunc.currentVersion,
EventType: cloudfront.LambdaEdgeEventType_VIEWER_REQUEST,
},
},
},
})