Searching assets - Amazon IoT SiteWise
PrerequisitesAdvanced search on Amazon IoT SiteWise console
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).

Searching assets

Use the Amazon IoT SiteWise console search functionality to find assets based on metadata and real-time property value filters.

Amazon IoT SiteWise requires permissions to integrate with Amazon IoT TwinMaker to better organize, and model industrial data. If you have granted permissions to Amazon IoT SiteWise, use the ExecuteQuery API. If you have not granted permissions to Amazon IoT SiteWise, and need assistance getting started, see Integrating Amazon IoT SiteWise and Amazon IoT TwinMaker.

  1. Navigate to the Amazon IoT SiteWise console.

  2. In the navigation pane, choose Advanced search under Assets.

  3. Under Advanced search choose the Metadata search option.

  4. Fill in the parameters. Fill in as many fields as possible for an efficient search.

    1. Asset name — Enter a full asset name, or a partial name for a wide search.

    2. Property name — Enter a full property name, or a partial name for a wide search.

    3. Operator — Choose an operator from:

      • =

      • <

      • >

      • <=

      • >=

    4. Property value — This value is compared with the property's latest value.

    5. Property value type — The data type of the property. Choose from the following:

      • Double

      • Integer

      • String

      • Boolean

  5. Choose Search.

  6. From the Search results table, choose the asset from the Name column. This takes you to the detailed asset page for that asset.

metadata search results.

All parameters do not need to be provided for an asset search. Here are some examples of partial searches using the Metadata search option:

  • Find assets by their name:

    • Enter a value in the Asset name field alone.

    • The Property name and Property value fields are empty.

  • Find assets containing properties with a specific name:

    • Enter a value in the Property name field alone.

    • The Asset name and Property value fields are empty.

  • Find assets based on the latest values of their properties:

    • Enter values in the Property name and Property value fields.

    • Select an Operator and Property value type.

  1. Navigate to the Amazon IoT SiteWise console.

  2. In the navigation pane, choose Advanced search under Assets.

  3. Under Advanced search choose the Query builder option.

  4. In the Query builder pane, write your SQL query to retrieve an asset_name, asset_id and asset_description.

  5. Choose Search.

  6. From the Search results table, choose the asset from the Name column. This takes you to the detailed asset page for that asset.

query builder search results.
Note

  • The SELECT clause in the SQL query must include the asset_name and asset_id fields to ensure a valid asset in the Search results table.

  • The Query builder only displays the Name, Asset id, and Description in the results table. Adding more fields to the SELECT clause does not add more columns to the results table