pool.snapshot.update

Type: object

Call parameters

Type: array
No Additional Items

Tuple Validation

Parameter 1: id

id

Type: string

ID of the snapshot to update.

Parameter 2: data

data

Type: object

The property updates to apply to the snapshot.

No Additional Properties

user_properties_update

User Properties Update

Type: array of object Default: []

Properties to update.

No Additional Items

Each item of this array must be:

PoolSnapshotUserPropertyUpdate

Type: object
No Additional Properties

key Required

Key

Type: string

ZFS user property key in namespace:property format (e.g., 'custom:backuppolicy', 'org:createdby').

Must match regular expression: .*:.*

value Required

Value

Type: string

The new value to assign to the user property.

user_properties_remove

User Properties Remove

Type: array of string Default: []

Properties to remove.

No Additional Items

Each item of this array must be:

Type: string

ZFS user property key in namespace:property format (e.g., 'custom:backuppolicy', 'org:createdby').

Must match regular expression: .*:.*

Return value

PoolSnapshotCreateUpdateEntry

Type: object

Information about the updated snapshot.

No Additional Properties

id Required

Id

Type: string

Full snapshot identifier including dataset and snapshot name.

properties Required

Properties

Type: object

Object mapping ZFS property names to their values and metadata.

Additional Properties

Each additional property must conform to the following schema

PoolSnapshotEntryPropertyFields

Type: object
No Additional Properties

value Required

Value

Type: string

Current effective value of the ZFS property as a string.

rawvalue Required

Rawvalue

Type: string

Raw string value of the ZFS property as stored.

source Required

Source

Type: enum (of string)

Source of the property value.

• NONE: Property is not set
• DEFAULT: Using ZFS default value
• LOCAL: Set locally on this snapshot
• TEMPORARY: Temporary override value
• INHERITED: Inherited from parent dataset
• RECEIVED: Set by ZFS receive operation

Must be one of:

• "NONE"
• "DEFAULT"
• "LOCAL"
• "TEMPORARY"
• "INHERITED"
• "RECEIVED"

parsed Required

Parsed

Type: object

Property value parsed into the appropriate type (string, boolean, integer, etc.).

pool Required

Pool

Type: string

Name of the ZFS pool containing this snapshot.

name Required

Name

Type: string

Full name of the snapshot including dataset path.

type Required

Type

Type: const

Type identifier indicating this is a ZFS snapshot.

Must be one of:

• "SNAPSHOT"

Specific value: "SNAPSHOT"

snapshot_name Required

Snapshot Name

Type: string

Just the snapshot name portion without the dataset path.

dataset Required

Dataset

Type: string

Name of the dataset this snapshot was taken from.

createtxg Required

Createtxg

Type: string

Transaction group ID when the snapshot was created.

Required roles: SNAPSHOT_WRITE