---
title: "cluster list-locks"
slug: "cluster-list-locks"
updated: 2026-10-27T17:24:49Z
published: 2026-10-27T17:24:49Z
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 --path FILE_PATH
                  [--tenant-id TENANT_ID]
                  [--direction prev|next]
```

## Required Parameters

| `--path FILE_PATH` | Specifies the file path. Specify `FILE_PATH` as the full file path relative to the tenant. |
| --- | --- |

## Options

| `--tenant-id TENANT_ID` | Specifies the tenant under which the file resides. Defaults to the default tenant. |
| --- | --- |
| `--direction prev\|next` | Specifies pagination direction. |

## 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 |
+------+-------------+--------+-------+-----------+--------+--------+------+-------+-----------+-------------+---------+---------+-------------------+-----------+---------------------+
+------+-------------+--------+-------+-----------+--------+--------+------+-------+-----------+-------------+---------+---------+-------------------+-----------+---------------------+
```