Updating an IoT Flow Runtime

Update editable properties for an OCI IoT Flow Runtime.

Update the display name, description, scale, network configuration, File Storage mounts, or tags for an IoT Flow Runtime. For mount prerequisites and path requirements, see Configuring File Storage Access for an IoT Flow Runtime.

To update the Node-RED flows document for a Flow Runtime, see Updating the Flows for an IoT Flow Runtime.

    1. On the IoT Domains list page, select the domain you want to work with. If you need help finding the IoT domains list page or IoT domains, see Listing IoT Domains.
    2. Select Flow runtimes.
    3. Select the runtime name.
    4. On the IoT Flow Runtime details page, select Edit to update the Flow Runtime's name, description, scale, log location, network access, or tags. For network access, select or paste the subnet and up to five network security groups required by the flows.
    5. To add or change File Storage mounts, turn on Configure file storage mounts. Select the File system export compartment and File system export. For Mount path, enter a relative path without a leading or trailing slash or path traversal segments. Select Add file storage mount to configure another export, up to a limit of five.

      The Console displays /mnt/ as a fixed, non-editable prefix. For example, enter my-share to make the export available at /mnt/my-share.

    6. Select Save changes.
  • Use oci iot flow-runtime update.

    oci iot flow-runtime update --iot-flow-runtime-id <flow-runtime-OCID> --scale HIGH --network-config file://network-config.json
    To clear or remove the network configuration, use --network-config null:
    oci iot flow-runtime update --iot-flow-runtime-id <flow-runtime-OCID> --network-config null

    For all options, see CLI Command Reference.

  • Run the UpdateIotFlowRuntime operation to update an IoT Flow Runtime.

    PUT /20250531/iotFlowRuntimes/{iotFlowRuntimeId}
    {
      "displayName": "Updated Flow Runtime",
      "scale": "HIGH",
      "networkConfig": {
        "subnetId": "ocid1.subnet.oc1..exampleuniqueID",
        "networkSecurityGroupIds": []
      }
    }

    Updates are partial. Omitting networkConfig preserves the existing configuration. Providing it replaces the complete configuration. To remove the configuration, pass networkConfig as null.