AWS IoT Greengrass Version 1 - Getting Started with AWS services in China
AWS services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with AWS services in China.

AWS IoT Greengrass Version 1

AWS IoT Greengrass seamlessly extends AWS onto physical devices so they can act locally on the data they generate, while still using the cloud for management, analytics, and durable storage. AWS IoT Greengrass ensures your devices can respond quickly to local events and operate with intermittent connectivity. AWS IoT Greengrass minimizes the cost of transmitting data to the cloud by enabling you to author custom software and AWS Lambda functions that run on local devices.

Region Availability

AWS IoT Greengrass is available in the following regions in China:

  • Beijing Region

Feature Availability and Implementation Differences

The AWS services in China implementation of AWS IoT Greengrass is unique in the following ways:

  • Currently, AWS IoT Greengrass is available in the Beijing Region only.

  • AWS IoT Greengrass Core software v1.9.2 is the minimum supported version in the Beijing Region.

  • The following minimum versions of the AWS IoT Greengrass Core SDK are supported:

    Language or platform Minimum version

    Python 3.7

    1.4.0

    Java 8

    1.3.1

    Node.js 8.10

    1.4.0

    C, C++

    1.1.0

  • The Beijing Region only supports Amazon Trust Services (ATS) server authentication, so you must use ATS-signed root CA certificates and ATS endpoints. For more information, see Server Authentication in the AWS IoT guide.

    • Amazon Trust Services (ATS) endpoints in the China region are different from other global endpoints. For example, the AWS IoT Greengrass ATS endpoint in the Beijing Region is greengrass.ats.iot.cn-north-1.amazonaws.com.cn. For more information, see China (Beijing) Region Endpoints in the AWS General Reference.

  • The default maximum number of transactions per second (TPS) on the AWS IoT Greengrass API is 10. For more information, see AWS IoT Greengrass Limits in the AWS General Reference.

  • Currently, only the following connectors are supported in the Beijing Region:

    • Modbus-RTU Protocol Adapter connector, v2

    • Raspberry Pi GPIO connector, v2

    • Serial Stream connector, v2

    • Docker application deployment connector, v5 and v6

Guides and References

AWS services in China user guides are available in HTML and PDF, in both Chinese and English. API references are available in HTML and PDF. Some API references may be available only in English. Currently, not all API references are available in the Beijing and Ningxia Regions. Links to some API references will take you to the global AWS site. Note that some features and functionality described in the guides and references may not be available in the current AWS services in China release.

General Information About AWS services in China

The following information applies to all AWS services that are available in the China Regions.

AWS Accounts in the China Regions

To use services in the Beijing and Ningxia Regions, you need an account and credentials specific to each of those Regions.

  • Accounts and credentials for other AWS Regions will not work for services operating in the Beijing and Ningxia Regions.

  • Accounts and credentials for the Beijing and Ningxia Regions will not work for other AWS Regions.

  • For more information, see Signup, Accounts, and Credentials

Domain for AWS services in China

The domain for AWS services in China is www.amazonaws.cn.

Endpoints & Amazon Resource Names (ARNs)

For information about endpoints and ARNs in AWS services in China, see Endpoints and ARNs for AWS services in China

Availability Zones for the China Regions

  • In the Beijing Region, there are two Availability Zones.

  • In the Ningxia Region, there are three Availability Zones.

General Information for AWS services in China

The following applies to all AWS services that are available in the China Regions. For detailed information about specific AWS services, see the service-specific topic in this guide.

  • AWS Identity and Access Management (IAM)

    • You can grant or deny a service access to resources using the Principal policy element.

    • Service principal values vary by Region.

  • EC2-Classic Platform

    • The EC2-Classic platform is not supported.

  • Free Usage Tier

    • The free usage tier is supported in the Ningxia Region.

    • The free usage tier is not supported in the Beijing Region.

AWS Console

The console for AWS services in China is unique to China. The screenshots in the AWS guides might differ from what you see on your console. For information about differences in service functionality, see the topics for each service in this guide.

Code Examples

The AWS documentation might include endpoints and ARNs in code examples that are not specific to the Beijing and Ningxia Regions. When using examples, verify you are using the endpoints and ARNs for your Region.