Oracle Cloud Infrastructure Documentation

Listing IoT Flow Runtimes

List IoT Flow Runtime resources in a compartment or IoT domain.

An IoT Flow Runtime represents a Node-RED editor instance that you can use to build and run flows in an IoT domain.

    1. Open the navigation menu, select Developer Services, select IoT domains, and then open the IoT domain that contains the flow runtime. Or open the IoT domain where you want to create the flow runtime.
    2. Select Flow runtimes.
    3. The Flow runtimes list page opens. All the IoT flow runtimes in the selected compartment are displayed in a table.
    4. To view flow runtimes 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.

    5. From the IoT flow runtimes list, select a name to view details for an IoT runtime.

    Filtering List Results

    Use filters to limit the distribution channels in the list. 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 IoT flow runtime to open its details page, to view its status and perform other tasks.

    To perform an action on a IoT flow runtime directly from the list table, select an available option from the Actions menu at the end of the row for that flow runtime:
    • Edit: Update the name, description, scale, logging or network access options for the flow runtime.
    • Deploy Flows: Replace the complete flows JSON without opening the Flow runtime editor. Upload or paste the flows JSON.
    • Activate: Enable the IoT flow runtime to process incoming messages. Activated flows run after you select Deploy.
    • Deactivate: Disable or pause the IoT flow runtime, so no messages are processed.
    • Delete: Delete the IoT flow runtime.
    • Move Resource: Select a compartment where you want to move this flow runtime.
    • Manage tags: Add one or more tags to the IoT flow runtime, or change the value of an existing tag. See Resource Tags.
    • Copy OCID: Copy the OCID of the IoT flow runtime to the clipboard.
    To create an IoT flow runtime, select IoT flow runtime and select Create.

  • Use the oci iot flow-runtime list command and required parameters to list IoT Flow Runtime resources. Replace <compartment-OCID> with the compartment OCID. To filter by IoT domain, replace <iot-domain-OCID> with the IoT domain OCID.

    oci iot flow-runtime list --compartment-id <compartment-OCID> --iot-domain-id <iot-domain-OCID>

    You can also filter list results by display name, lifecycle state, and pagination options such as limit and page.

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

  • Run the ListIotFlowRuntimes operation to list IoT Flow Runtimes.

    GET /20250531/iotFlowRuntimes?compartmentId=<compartment-OCID>&iotDomainId=<iot-domain-OCID>

    The response returns an IotFlowRuntimeCollection with summary items for matching IoT Flow Runtime resources.