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

> ## 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.

# cluster list-locks

This command lists open byte range locks.

## Usage

```plaintext
cluster list-locks --file-path PATH
                  [--tenant-id ID]
                  [--direction prev|next]
```

## Required Parameters

| `--file-path PATH` | Specify the file path within the tenant. |
| --- | --- |

## Options

| `--tenant-id ID` | Specify the ID of the tenant where the file resides. If this option is not specified, the default tenant is used. |
| --- | --- |
| `--direction prev\|next` | Set the pagination direction. |
| `--vertical` | Formats the output so that the fields for each item are displayed beneath it. If not specified, the fields extend horizontally to the right. |

## Example

```plaintext
vcli: admin> cluster list-locks --path /open.txt
+------+-------------+--------+-------+-----------+--------+--------+------+-------+-----------+-------------+---------+---------+-------------------+-----------+---------------------+
| Type | Create-Time | Caller | Owner | Exclusive | Offset | Length | Svid | State | Lock-path | Tenant-name | Open-id | Lock-id | Lock-granted-type | Client-id | Create-time-seconds |
+------+-------------+--------+-------+-----------+--------+--------+------+-------+-----------+-------------+---------+---------+-------------------+-----------+---------------------+
+------+-------------+--------+-------+-----------+--------+--------+------+-------+-----------+-------------+---------+---------+-------------------+-----------+---------------------+
```