---
title: "openfilesquery list"
slug: "openfilesquery-list"
tags: ["5.5"]
updated: 2026-10-27T23:00:54Z
published: 2026-10-27T23:00:54Z
canonical: "docs.vastdata.com/openfilesquery-list"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# openfilesquery list

This command shows a list of queries that have been performed to search for open files.

## Usage

```plaintext
openfilesquery list  [--path-prefix-contains STRING]
                     [--name-contains STRING]
                     [--tenant-id ID]
                     [--created-gte TIMESTAMP]
                     [--created-lte TIMESTAMP]
                     [--state STATE]
                     [--page-size COUNT]
                     [--page NUMBER]
```

## Options

| `--path-prefix-contains STRING` | Filters the output to include only queries with paths containing the specified string. |
| --- | --- |
| `--name-contains STRING` | Filters the output to include only queries with names containing the specified string. |
| `--tenant-id ID` | Includes only queries for the specified tenant. |
| `--created-gte TIMESTAMP` | Incldues only queries created on or after the specified date and time (in format YYYY-MM-DD HH:MM:SS). |
| `--created-lte TIMESTAMP` | Incldues only queries on or before the specified date and time (in format YYYY-MM-DD HH:MM:SS). |
| `--state STATE` | Filter the output by query state. Valid values for `STATE` are `RUNNING`, `COMPLETED`, `PARTIALLY_COMPLETED`, `FAILED`. |
| `--page-size COUNT` | Sets the maximum number of entries in an output page. Valid values: 1-1000. Default: 100. |
| `--page PAGE-NUMBER` | Displays a particular output page. By default, page 1 is displayed. Using this option requires that the page size (`--page-size`) is specified. |

## Example

```plaintext
vcli: admin> openfilesquery list
+----+---------------------+-----------+-------------+-------------------------------------+---------------+-----------+--------------------+
| ID | Created             | Tenant-id | Path-prefix | Filters                             | Async-task-id | State     | Name               |
+----+---------------------+-----------+-------------+-------------------------------------+---------------+-----------+--------------------+
| 1  | 2025-10-30 12:38:52 | 1         | /           | {'return_only_locked_files': False} | 4             | COMPLETED | query_/_1761827932 |
+----+---------------------+-----------+-------------+-------------------------------------+---------------+-----------+--------------------+
```