---
title: "openfilesquery query-open-file-handles"
slug: "openfilesquery-query-open-file-handles"
tags: ["5.4"]
updated: 2026-10-28T01:53:01Z
published: 2026-10-28T01:53:01Z
canonical: "docs.vastdata.com/openfilesquery-query-open-file-handles"
---

> ## 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 query-open-file-handles

This command retrieves a list of open handles for a file.

**NOTE**: This command is available starting with VAST Cluster 5.4.1.

To view the retrieved handles, use the `openfilesquery list-open-file-handles` command.

## Usage

```plaintext
openfilesquery query-open-file-handles --file-id ID
```

## Required Parameters

| `--file-id ID` | The ID of the open file for which you want to list open handles. The ID can be obtained with the `openfilesquery list-open-files` command. |
| --- | --- |

## Example

To retrieve open handles for file with ID 2569214:

```plaintext
vcli: admin> openfilesquery query-open-file-handles --file-id 2569214

Waiting ...
[2025-10-21 11:10:33] Getting open file handles for /abc/tdir0/file3456909 on tenant default
[2025-10-21 11:10:33] File has no locks, skipping locks retrieval per handle
[2025-10-21 11:10:33] Retrieved 2 open handles successfully ... |

Completed
```