Device Management
Device Search

Device Search

The syntax supported in the search input field on the Devices page is as follows.

  • id:foo: Search for devices whose ID contains foo
  • name:foo: Search for devices whose name contains foo
  • tag:foo: Search for devices with the tag foo
  • foundness:foo: Search for devices with a connection state of foo (foo is Found or NotFound)
  • ssid:foo: Search for devices whose Connected SSID contains foo
  • act:foo: Search for devices on which Act of ID foo is installed
  • since:foo: Search for devices that were registered after foo
    • foo is in ISO 8601 format (e.g. 2020-08-27T17:00:00+09:00)
  • until:foo: Search for devices that were registered before foo
    • foo is in ISO 8601 format (e.g. 2020-08-27T17:00:00+09:00)
  • found_since:foo: Search for devices that were connected since foo (deprecated)
    • foo is in ISO 8601 format (e.g. 2020-08-27T17:00:00+09:00)
  • found_until:foo: Search for devices that were connected until foo (deprecated)
    • foo is in ISO 8601 format (e.g. 2020-08-27T17:00:00+09:00)
  • last_connected_since:foo: Search for devices that were last connected since foo (inclusive)
    • foo is in ISO 8601 format (e.g. 2020-08-27T17:00:00+09:00)
  • last_connected_until:foo: Search for devices that were last connected before foo (exclusive)
    • foo is in ISO 8601 format (e.g. 2020-08-27T17:00:00+09:00)
  • last_disconnected_since:foo: Search for devices that were last disconnected since foo (inclusive)
    • foo is in ISO 8601 format (e.g. 2020-08-27T17:00:00+09:00)
  • last_disconnected_until:foo: Search for devices that were last disconnected before foo (exclusive)
    • foo is in ISO 8601 format (e.g. 2020-08-27T17:00:00+09:00)
  • hardware_id:foo: Search for devices whose hardware id contains foo
  • If you enter a string that is not one of the above, search for the devices whose tag name matches the entered string, or whose ID or name contains the entered string.

To search for devices that match multiple conditions (AND search), separate them with a space.

name:foo tag:bar

To search for devices that match any of the conditions (OR search), separate them with OR.

id:foo OR id:bar

Note: The current specification does not allow spaces in search words. We recommend that you do not use spaces in device names and tag names.

Search Examples

To search for devices that came online after a certain time and have stayed online:

last_connected_since:2024-01-01T00:00:00+09:00 foundness:Found

To search for devices that went offline before a certain time and have stayed offline:

last_disconnected_until:2024-01-01T00:00:00+09:00 foundness:NotFound
Last updated on