Skip to content
v2.277.0

ExecutionProperty Struct ​

Configuration settings for the Lambda execution environment on the AWS IoT Greengrass core.

In an CloudFormation template, Execution is a property of the DefaultConfig property type for a function definition version and the Environment property type for a function.

Example ​

ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_greengrass as greengrass } from 'aws-cdk-lib';
const executionProperty: greengrass.CfnFunctionDefinitionVersion.ExecutionProperty = {
  isolationMode: 'isolationMode',
  runAs: {
    gid: 123,
    uid: 123,
  },
};
python
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_greengrass as greengrass

execution_property = greengrass.CfnFunctionDefinitionVersion.ExecutionProperty(
    isolation_mode="isolationMode",
    run_as=greengrass.CfnFunctionDefinitionVersion.RunAsProperty(
        gid=123,
        uid=123
    )
)
java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.greengrass.*;

ExecutionProperty executionProperty = ExecutionProperty.builder()
        .isolationMode("isolationMode")
        .runAs(RunAsProperty.builder()
                .gid(123)
                .uid(123)
                .build())
        .build();
csharp
// Install: dotnet add package Amazon.CDK.Lib
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.Greengrass;

var executionProperty = new ExecutionProperty {
    IsolationMode = "isolationMode",
    RunAs = new RunAsProperty {
        Gid = 123,
        Uid = 123
    }
};
go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import "github.com/aws/aws-cdk-go/awscdk"

executionProperty := &ExecutionProperty{
	IsolationMode: jsii.String("isolationMode"),
	RunAs: &RunAsProperty{
		Gid: jsii.Number(123),
		Uid: jsii.Number(123),
	},
}

Properties ​

isolationModeoptionalstringisolation_modeoptionalstrisolationModeoptionalStringIsolationModeoptionalstringIsolationModeoptional*string #
The containerization that the Lambda function runs in.
notes

Valid values are GreengrassContainer or NoContainer . Typically, this is GreengrassContainer . For more information, see Containerization in the Developer Guide .

  • When set on the DefaultConfig property of a function definition version, this setting is used as the default containerization for all Lambda functions in the function definition version.
  • When set on the Environment property of a function, this setting applies to the individual function and overrides the default. Omit this value to run the function with the default containerization.

We recommend that you run in a Greengrass container unless your business case requires that you run without containerization.

runAsoptionalIResolvable | CfnFunctionDefinitionVersion.RunAsPropertyrun_asoptionaltyping.Union[IResolvable, RunAsProperty]runAsoptionalIResolvableRunAsoptionalIResolvableRunAsoptionalinterface{} #
The user and group permissions used to run the Lambda function.
notes

Typically, this is the ggc_user and ggc_group. For more information, see Run as in the Developer Guide .

  • When set on the DefaultConfig property of a function definition version, this setting is used as the default access identity for all Lambda functions in the function definition version.
  • When set on the Environment property of a function, this setting applies to the individual function and overrides the default. You can override the user, group, or both. Omit this value to run the function with the default permissions.

Running as the root user increases risks to your data and device. Do not run as root (UID/GID=0) unless your business case requires it. For more information and requirements, see Running a Lambda Function as Root .