Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

AWS::Greengrass::FunctionDefinition RunAs

Focus mode

On this page

AWS::Greengrass::FunctionDefinition RunAs - AWS CloudFormation
Filter View

The access identity whose permissions are used to run the Lambda function. This setting overrides the default access identity that's specified for the group (by default, ggc_user and ggc_group). You can override the user, group, or both. For more information, see Run as in the AWS IoT Greengrass Version 1 Developer Guide .

Important

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.

In an AWS CloudFormation template, RunAs is a property of the Execution property type.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{ "Gid" : Integer, "Uid" : Integer }

YAML

Gid: Integer Uid: Integer

Properties

Gid

The group ID whose permissions are used to run the Lambda function. You can use the getent group command on your core device to look up the group ID.

Required: No

Type: Integer

Update requires: Replacement

Uid

The user ID whose permissions are used to run the Lambda function. You can use the getent passwd command on your core device to look up the user ID.

Required: No

Type: Integer

Update requires: Replacement

See also

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.