# pool.dataset.lock

Locks id dataset. It will unmount the dataset and its children before locking.

After the dataset has been unmounted, system will set immutable flag on the dataset’s mountpoint where the dataset was mounted before it was locked making sure that the path cannot be modified. Once the dataset is unlocked, it will not be affected by this change and consumers can continue consuming it.

This method is a job.

Type: object

##

Type: array
No Additional Items

#### Tuple Validation

##### Parameter 1: id

#### id

Type: string

The dataset ID (full path) to lock.

##### Parameter 2: options

#### options

Type: object

Options for locking the dataset, such as force unmount settings.

No Additional Properties

##

#### Force Umount

Type: boolean Default: false

Force unmounting of the dataset before locking.

##

#### Result

Type: const

Dataset is locked.

Specific value: `true`

Required roles: DATASET_WRITE