Configuring data sources (Amazon CLI) - Amazon IoT SiteWise
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).

Configuring data sources (Amazon CLI)

You can use the Amazon IoT SiteWise API and Amazon Command Line Interface to add sources to your Amazon IoT SiteWise Edge gateway. You define sources in SiteWise Edge gateway capabilities. A SiteWise Edge gateway capability represents a software feature that runs on the SiteWise Edge gateway, such as the capability to collect industrial data from OPC-UA sources.

SiteWise Edge gateway capabilities have the following components:

  • A configuration – A JSON document that defines all of the data sources for a capability.

  • A namespace – A unique string that identifies the type and version of a capability. For example, the OPC-UA source capability namespace is iotsitewise:opcuacollector:version, where version is the version of the OPC-UA capability. All OPC-UA sources are defined in one capability with this namespace.

  • A synchronization status – A status that indicates if a capability is synchronized between the Amazon Cloud and the SiteWise Edge gateway. The sync status can be one of the following:

    • IN_SYNC – The SiteWise Edge gateway is running the capability configuration.

    • OUT_OF_SYNC – The SiteWise Edge gateway hasn't received the capability configuration.

    • SYNC_FAILED – The SiteWise Edge gateway rejected the capability configuration.

    After you update a capability configuration, its sync status is OUT_OF_SYNC until the SiteWise Edge gateway receives and applies or rejects the updated configuration.

Use the following operations to query and update your SiteWise Edge gateway sources and capability configurations:

  • DescribeGateway – Retrieves information about a specific SiteWise Edge gateway. The response includes a list of capability summaries, including capability namespaces.

  • DescribeGatewayCapabilityConfiguration – Retrieves the configuration of a specific capability. Use this operation to retrieve a capability configuration to update.

  • ListGateways – Lists information about all SiteWise Edge gateways. The response includes a list of capability summaries for each SiteWise Edge gateway, including capability namespaces.

  • UpdateGatewayCapabilityConfiguration – Updates a SiteWise Edge gateway capability configuration or defines a new capability configuration. This operation identifies capabilities by a capability namespace. If you provide a namespace that already exists, this operation updates the capability for that namespace. Otherwise, this operation creates a new capability.

    Warning

    The UpdateGatewayCapabilityConfiguration operation overwrites the existing capability configuration with the configuration that you provide in the payload. To avoid deleting your capability's configuration, you must add to the existing configuration when you update the capability.