---
title: "cluster release-lock"
slug: "cluster-release-lock"
updated: 2026-10-28T01:52:11Z
published: 2026-10-28T01:52:11Z
canonical: "docs.vastdata.com/cluster-release-lock"
---

> ## 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 release-lock

This command releases locks on a specified file path.

## Usage

```plaintext
cluster release-lock --path PATH
                    [--cluster-id ID]
                    [--tenant-id ID]
                    [--recursively]
                    [--unlock-type ALL|SINGLE]
                    [--unlock-id ID]
                    [--lock-type TYPE]
```

## Required Parameters

| `--path PATH` | Specify a file path within the tenant. This can be a path to a file or, if the `--recursively` option is used, to a directory. |
| --- | --- |

## Options

| `--cluster-id ID` | Specifies the cluster ID. You can verify the cluster ID by running `cluster list`. Default: 1. |
| --- | --- |
| `--tenant-id ID` | Specify the ID of the tenant where the file resides. If this option is not specified, the default tenant is used. |
| `--recursively` | Recursively deletes all locks under the path. |
| `--unlock-type ALL\|SINGLE` | The type of unlock operation to perform: - `ALL`. To unlock all locks. - `SINGLE`. To unlock a single lock. |
| `--unlock-id ID` | If `--unlock-type SINGLE` is used, include this option to specify the unlock ID for the specific lock that you want to unlock. |
| `--lock-type TYPE` | If `--unlock-type SINGLE` is used, include this option to specify the lock type: - `NLM4`. An NLM4 lock taken by an NFSv3 client. - `NFSv4`. An NFSv4 lock. - `SMB`. An SMB lock. |

## Example

```plaintext
vcli: admin> cluster release-lock --path /dev/test.txt --unlock-type ALL
```