Oracle Cloud Infrastructure Documentation

Listing Digital Twin Instances

List digital twin instances for your Internet of Things (IoT).

    1. Open the navigation menu, select Developer Services. Under Internet of Things, select Domains. The IoT domain list page opens. All the domains in the selected compartment are displayed.
    2. To view the IoT domains in a different compartment, use the Compartment filter to switch compartments.

      You must have permission to work in a compartment to see the resources in it. If you're not sure which compartment to use, contact an administrator. For more information, see Understanding Compartments.

    3. Select the IoT domain you want to work with, select the digital twin instances tab. All the associated digital twin instances are displayed.

    Filtering List Results

    Use filters to limit the digital twin instances in the list.
    • To filter the list by digital twin model instances, in the search and filter field select status and then the value you want from the Status filter. Use this option to search for Active or Deleted digital twin instances.
    • From the Search and Filter box above the list table, select one or more filters and specify the values that you want to use to narrow the list. In general, the filters correspond to the columns shown in the list table, although some filters represent attributes that aren't shown in the table. The Compartment filter is always displayed next to Applied filters.
    • Change the order of the items in the list table by using the sort icons next to the column names.

    Actions

    In the list table, select the name of a digital twin instance to open its details page. For a complete description of an IoT digital twin instance settings, see Creating a Digital Twin Instance.

    View or copy the description, the associated digital twin model, an associated digital twin adapter, an authentication ID, the associated IoT domain, the associated digital twin model's DTDL specification URI (DTMI), the External key, the OCID, and the timestamp for when this digital twin instance was created or updated. You can edit tags.

    Select the Data tab, to view the latest snapshot data for this instance, including the current state of all properties and telemetry defined in the associated digital twin model. No data is returned if a model is not associated with the instance. For more information, see IoT Domain Database Schema Reference.

    To perform an action on an digital twin instance directly from the list table, select any of the following options from the Actions menu in the row for that digital twin instance:
    • Delete
    • Manage tags
    • Copy OCID

  • Use the oci iot digital-twin-instance list command and the required parameter to list digital twin instances for a specific IoT domain:

    oci iot digital-twin-instance list --iot-domain-id <iot-domain-OCID>

  • Run the ListDigitalTwinInstances operation to list digital twin instances.