Amazon IoT Greengrass Version 1 - Getting Started with Amazon Web Services in China
Region AvailabilityFeature Availability and Implementation DifferencesGuides and ReferencesGeneral Information About Amazon Web Services in China
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Amazon IoT Greengrass Version 1

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

Region Availability

Amazon IoT Greengrass V1 is available in the following regions in China:

  • Beijing Region

Feature Availability and Implementation Differences

The Amazon Web Services in China implementation of Amazon IoT Greengrass is unique in the following ways:

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

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

  • The following minimum versions of the Amazon 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 Amazon IoT guide.

    • Amazon Trust Services (ATS) endpoints in the China region are different from other global endpoints. For example, the Amazon IoT Greengrass V1 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 Amazon Web Services General Reference.

  • The default maximum number of transactions per second (TPS) on the Amazon IoT Greengrass V1 API is 10. For more information, see Amazon IoT Greengrass Limits in the Amazon Web Services 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, v4, v5, v6, and v7. Connector versions earlier than v7 don't support using secrets to access Docker images from private container registries or from Amazon Web Services Marketplace.

  • Currently, Amazon IoT Device Tester for Amazon IoT Greengrass V1 is not supported in the Beijing Region.

  • Currently, VPC endpoints (Amazon PrivateLink) for Amazon IoT Greengrass V1 are not supported in the Beijing Region.

Guides and References

Amazon Web 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 Amazon Web Services site. Note that some features and functionality described in the guides and references may not be available in the current Amazon Web Services in China release.

General Information About Amazon Web Services in China

The following information applies to all Amazon Web Services that are available in the China Regions.

Amazon Web Services 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 Amazon 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 Amazon Regions.

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

Domain for Amazon Web Services in China

The domain for Amazon Web Services in China is www.amazonaws.cn.

Endpoints & Amazon Resource Names (ARNs)

For information about endpoints and ARNs in Amazon Web Services in China, see Endpoints and ARNs for Amazon Web Services in China.

Availability Zones for the China Regions

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

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

General Information for Amazon Web Services in China

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

  • Amazon 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.

Amazon Web Services Console

The console for Amazon Web Services in China is unique to China. The screenshots in the Amazon Web Services 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 Amazon Web Services 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.