Services or capabilities described in this page might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China Regions. Only “Region Availability” and “Feature Availability and Implementation Differences” sections for specific services (in each case exclusive of content referenced via hyperlink) in Getting Started with Amazon Web Services in China Regions form part of the Documentation under the agreement between you and Sinnet or NWCD governing your use of services of Amazon Web Services China (Beijing) Region or Amazon Web Services China (Ningxia) Region (the “Agreement”). Any other content contained in the Getting Started pages does not form any part of the Agreement.

Amazon IoT Greengrass Documentation

Amazon IoT Greengrass is an open-source edge runtime and cloud service for building, deploying, and managing device software.

Key Features

Local processing for Amazon Lambda

Amazon IoT Greengrass includes support for Amazon Lambda. Amazon IoT Greengrass is designed so you can run Amazon Lambda functions on the device to respond quickly to local events, interact with local resources, and process data to minimize the cost of transmitting data to the cloud.

Local support for containers

Amazon IoT Greengrass is designed so you can deploy, run, and manage Docker containers on Amazon IoT Greengrass devices, including storing Docker images in Docker container registries, such as Amazon Elastic Container Registry (Amazon ECR), Docker Hub, or private Docker Trusted Registries (DTRs).

Local support for Amazon IoT Device Shadows

Amazon IoT Greengrass is also designed to include the functionality of Amazon IoT Device Shadows. The Device Shadow is designed to cache the state of your device, like a virtual version or “shadow,” of each device that tracks the device’s current versus desired state and synchronize that state with the cloud when connectivity is available.

Local messaging

Amazon IoT Greengrass is designed to enable messaging between the Amazon IoT Greengrass Core and devices using the Amazon IoT Device SDK on a local network, facilitating communication even when there is no connection to Amazon Web Services Cloud. Amazon IoT Greengrass is designed to allow your devices to process messages and deliver them to another device or to the cloud based on business rules you define.

Local development

Amazon IoT Greengrass is designed to let you rapidly develop and debug code on a test device before using the cloud to deploy to your production devices. The Amazon IoT Greengrass command-line interface (CLI) is designed so you can locally develop and debug applications on your device, and the local debug console is designed to help you visually debug applications.

Amazon IoT Greengrass ML Inference

Amazon IoT Greengrass ML Inference is a feature of Amazon IoT Greengrass that is designed to make it easy to perform machine learning inference locally on Amazon IoT Greengrass devices using models that are built and trained in the cloud. This helps you avoid data transfer costs or increased latency for applications that use machine learning inference. 

Stream Manager for Amazon IoT Greengrass

You can use Amazon IoT Greengrass to help you collect, process, and export data streams from IoT devices and manage the life cycle of that data on the device to minimize development time. Amazon IoT Greengrass is designed to provide a standard mechanism to process data streams, manage local data-retention policies, and transmit device data to Amazon Web Services cloud services such as Amazon Simple Storage Service (Amazon S3), Amazon Kinesis, Amazon IoT Core, and Amazon IoT Analytics.

Amazon IoT Greengrass components

Amazon IoT Greengrass provides pre-built components for common use cases so you can more easily discover and import, configure, and deploy applications and services at the edge. You can also create your own components or simply re-use common business logic from one Amazon IoT Greengrass device to another.  

Amazon IoT Greengrass is modular. It is designed so you can add or remove pre-built software components based on your IoT use case, and your device CPU and memory resources. For example, you can choose to include pre-built Amazon IoT Greengrass components such as stream manager only when you need to process data streams with your application, or machine learning components only when you want to perform machine learning inference locally on your devices. 

Manage IoT applications at scale

Amazon IoT Greengrass makes it easier to remotely deploy and manage device software on millions of devices. You can organize your devices in groups and deploy and manage device software and configuration to a subset of devices or to all devices at once. 

Over the air updates

Amazon IoT Greengrass is designed to allow for updates the Amazon IoT Greengrass Core software on Amazon IoT Greengrass devices using the Amazon IoT Greengrass console, APIs, or command-line interface, including updates to the version of Amazon IoT Greengrass Cores or components running on your devices.

Amazon IoT Greengrass Secrets Manager

Amazon IoT Greengrass Secrets Manager is designed to allow you to store, access, rotate, and manage secrets – credentials, keys, endpoints, and configurations – at the edge. With Amazon IoT Greengrass components integration, if an Amazon IoT Greengrass component needs a secret to authenticate with an application or service, this feature is designed so you can select and deploy a secret to the Amazon IoT Greengrass Core as part of the component configuration. For example, you can use Amazon IoT Greengrass Secrets Manager to configure credentials for private Docker container registries.

Hardware Security Integration

Amazon IoT Greengrass offers customers the option to store their device private key on a hardware secure element. You can store sensitive device information at the edge with Amazon IoT Greengrass Secrets Manager and encrypt your secrets using private keys for root of trust security. 

Amazon IoT Device Tester for Amazon IoT Greengrass

Amazon IoT Device Tester for Amazon IoT Greengrass is a test automation tool that helps you validate if your device meets the software and hardware requirements to run Amazon IoT Greengrass. It is designed to support configuration and dependency checks and end-to-end tests to validate if a device can support specific Amazon IoT Greengrass features such as Machine Learning Inference. 

Additional Information

For additional information about service controls, security features and functionalities, including, as applicable, information about storing, retrieving, modifying, restricting, and deleting data, please see https://docs.amazonaws.cn/en_us/. This additional information does not form part of the Documentation for purposes of the Sinnet Customer Agreement for Amazon Web Services (Beijing Region), Western Cloud Data Customer Agreement for Amazon Web Services (Ningxia Region) or other agreement between you and Sinnet or NWCD governing your use of services of Amazon Web Services China Regions.