pool.dataset.delete

Delete dataset/zvol id.

Delete “tank/myuser” dataset:

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "pool.dataset.delete",
    "params": ["tank/myuser"]
}

Type: object

Call parameters

Type: array
No Additional Items

Tuple Validation

Parameter 1: id

id

Type: string

The dataset ID (full path) to delete.

Parameter 2: options

options

Type: object

Options controlling the deletion behavior such as recursive and force flags.

No Additional Properties

recursive

Recursive

Type: boolean Default: false

Also delete/destroy all children datasets. When root dataset is specified as id with recursive, it will destroy all the children of the root dataset present leaving root dataset intact.

force

Force

Type: boolean Default: false

Delete datasets even if they are busy.

Return value

Result

Type: enum (of boolean or null)

Return true on successful deletion or null if the zfs destroy command fails with "dataset does not exist".

Must be one of:

• null
• true

Required roles: DATASET_DELETE