boot.environment.clone

Create a new boot environment named target as a clone of the existing boot environment identified by id. The clone is not activated; use boot.environment.activate to boot into it.

An EINVAL error is returned when id does not exist or has no associated kernel, or when target is not a valid boot environment name; an EEXIST error when a boot environment named target already exists.

Type: object

Type: array
No Additional Items

Tuple Validation

Parameter 1: boot_environment_clone

boot_environment_clone

Type: object

BootEnvironmentCloneArgs parameters.

 No Additional Properties

Id

Type: string

Must be at least 1 characters long

Target

Type: string

Must be at least 1 characters long

BootEnvironmentEntry

Type: object
No Additional Properties

Id

Type: string

The name of the boot environment referenced by the boot environment tool.

Must be at least 1 characters long

Dataset

Type: string

The name of the zfs dataset that represents the boot environment.

Must be at least 1 characters long

Active

Type: boolean

If active is True, this is the currently running boot environment.

Activated

Type: boolean

If True, this will be the boot environment that is used at next boot.

Created

Type: stringFormat: date-time

The date when the boot environment was created.

Used Bytes

Type: integer

The total amount of bytes used by the boot environment.

Used

Type: string

The boot environment's used space in human readable format.

Must be at least 1 characters long

Keep

Type: boolean

When set to false, this makes the boot environment subject to automatic deletion if the TrueNAS updater needs space for an update. Otherwise, the updater will not delete this boot environment if it is set to true.

Can Activate

Type: boolean

If set to true, the given boot environment may be activated.


Required roles: BOOT_ENV_WRITE