Oracle Cloud Infrastructure Documentation

Listing Digital Twin Models

List digital twin models 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 that's associated to the digital twin model you want to work with, select the digital twin models tab. All the associated digital twin models are displayed.

    Filtering List Results

    Use filters to limit the digital twin models in the list.
    • To filter the list by digital twin model status, 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 models.
    • 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.

    For more information about searching for resources and managing the columns in the list table, see Listing Resources.

    Actions

    In the list table, select the name of a digital twin model to open its details page, where you can view its status and perform other tasks including viewing or editing the DTDL Specification, Associated digital twin instances, Associated digital twin adapters, and Tags.

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

  • Use the oci iot digital-twin-model list command and the required parameter to list digital twin models in a specific IoT domain. Replace the <iot-domain-OCID> with the IoT domain's OCID:

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

    If you use the optional parameter --spec-uri-starts-with to list the digital twin models, when you replace the model specifications DTMI URI, do not include the version number. For example, this DTMI URI <dtmi:com:oracle:example:hvac;1> uses this value: <dtmi:com:oracle:example:hvac>

    For example:

    oci iot digital-twin-model list --iot-domain-id <iot-domain-OCID> --spec-uri-starts-with "<dtmi:com:oracle:example:hvac>"

    For a complete list of parameters and values for CLI commands, see CLI Command Reference.

  • Run the ListDigitalTwinModels operation to list digital twin models.