AWS IoT Greengrass Version 1 entered the extended life phase on June 30, 2023. For more information, see the AWS IoT Greengrass V1 maintenance policy. After this date, AWS IoT Greengrass V1 won't release updates that provide features, enhancements, bug fixes, or security patches. Devices that run on AWS IoT Greengrass V1 won't be disrupted and will continue to operate and to connect to the cloud. We strongly recommend that you migrate to AWS IoT Greengrass Version 2, which adds significant new features and support for additional platforms.
AWS IoT Greengrass and interface VPC endpoints
(AWS PrivateLink)
You can establish a private connection between your VPC and the AWS IoT Greengrass control plane by
creating an interface VPC endpoint. You can use this endpoint to manage
groups, Lambda functions, deployments, and other resources in the AWS IoT Greengrass service. Interface
endpoints are powered by AWS PrivateLink
Note
Currently, you can't configure Greengrass core devices to operate completely within your VPC.
Each interface endpoint is represented by one or more Elastic Network Interfaces in your subnets.
For more information, see Interface VPC endpoints (AWS PrivateLink) in the Amazon VPC User Guide.
Topics
Considerations for AWS IoT Greengrass VPC
endpoints
Before you set up an interface VPC endpoint for AWS IoT Greengrass, review Interface endpoint properties and limitations in the Amazon VPC User Guide. Additionally, be aware of the following considerations:
-
AWS IoT Greengrass supports making calls to all of its control plane API actions from your VPC. The control plane includes operations such as CreateDeployment and StartBulkDeployment. The control plane does not include operations such as GetDeployment and Discover, which are data plane operations.
-
VPC endpoints for AWS IoT Greengrass are currently not supported in AWS China Regions.
Create an interface VPC endpoint for
AWS IoT Greengrass control plane operations
You can create a VPC endpoint for the AWS IoT Greengrass control plane using either the Amazon VPC console or the AWS Command Line Interface (AWS CLI). For more information, see Creating an interface endpoint in the Amazon VPC User Guide.
Create a VPC endpoint for AWS IoT Greengrass using the following service name:
-
com.amazonaws.
region.greengrass
If you enable private DNS for the endpoint, you can make API requests to AWS IoT Greengrass using
its default DNS name for the Region, for example,
greengrass.us-east-1.amazonaws.com. Private DNS is enabled by
default.
For more information, see Accessing a service through an interface endpoint in the Amazon VPC User Guide.
Creating a VPC endpoint policy for AWS IoT Greengrass
You can attach an endpoint policy to your VPC endpoint that controls access to AWS IoT Greengrass control plane operations. The policy specifies the following information:
-
The principal that can perform actions.
-
The actions that the principal can perform.
-
The resources that the principal can perform actions on.
For more information, see Controlling access to services with VPC endpoints in the Amazon VPC User Guide.
Example: VPC endpoint policy for AWS IoT Greengrass actions
The following is an example of an endpoint policy for AWS IoT Greengrass. When attached to an endpoint, this policy grants access to the listed AWS IoT Greengrass actions for all principals on all resources.
{
"Statement": [
{
"Principal": "*",
"Effect": "Allow",
"Action": [
"greengrass:CreateDeployment",
"greengrass:StartBulkDeployment"
],
"Resource": "*"
}
]
}