# pool.snapshot.rename

Rename a snapshot id to new_name.

No safety checks are performed when renaming ZFS resources. If the dataset is in use by services such as SMB, iSCSI, snapshot tasks, replication, or cloud sync, renaming may cause disruptions or service failures.

Proceed only if you are certain the ZFS resource is not in use and fully understand the risks. Set Force to continue.

Type: object

##

Type: array
No Additional Items

#### Tuple Validation

##### Parameter 1: id

#### id

Type: string

Current ID of the snapshot to rename.

Must be at least `1` characters long

##### Parameter 2: options

#### options

Type: object

The rename operation options including the new name and force flag.

No Additional Properties

##

#### New Name

Type: string

The new name for the snapshot.

Must be at least `1` characters long

##

#### Force

Type: boolean Default: false

This operation does not check whether the dataset is currently in use. Renaming an active dataset may disrupt SMB shares, iSCSI targets, snapshots, replication, and other services.

Set Force only if you understand and accept the risks.

##

#### Recursive

Type: boolean Default: false

Recursively rename the snapshots of all descendant resources.

##

#### Result

Type: null

Returns `null` on successful snapshot rename.

Required roles: SNAPSHOT_WRITE