zfs.resource.list¶
Changes made to filesystems and volumes through this API or the zfs command. Destroying or exporting a whole pool emits nothing for its datasets.
ZFSResourceListAddedEvent
Type: objectNo Additional Properties
Id
Type: stringPath of the filesystem or volume that was created or renamed into place.
ZFSResourceEntry
Type: objectThe resource as read back after the operation.
No Additional PropertiesCreatetxg
Type: integerTransaction group when resource was created.
Guid
Type: integerGlobally unique identifier for the resource.
Name
Type: stringThe name of the zfs resource.
Pool
Type: stringThe name of the zpool that the zfs resouce is associated to.
The zfs properties for the resource.
ZFSPropertiesEntry
Type: objectNo Additional Properties
Aclinherit
Type: objectControls how ACEs are inherited for new files/directories.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
SourceValue
Type: objectNo Additional Properties
Type
Type: enum (of string)The source type.
Must be one of:
- "NONE"
- "DEFAULT"
- "TEMPORARY"
- "LOCAL"
- "INHERITED"
- "RECEIVED"
Value
The source value.
Value
The parsed raw value of the property.
Aclmode
Type: objectDetermines how ACLs are modified during chmod operations.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Acltype
Type: objectSpecifies type of ACL to use (off, nfsv4, posix).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Atime
Type: objectControls whether access time is updated on file reads.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Canmount
Type: objectControls whether filesystem can be mounted.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Casesensitivity
Type: objectDetermines filename matching algorithm sensitivity.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Defaultgroupobjquota
Type: objectDefault object quota for new groups.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Defaultgroupquota
Type: objectDefault space quota for new groups.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Defaultprojectobjquota
Type: objectDefault object quota for new projects.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Defaultprojectquota
Type: objectDefault space quota for new projects.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Defaultuserobjquota
Type: objectDefault object quota for new users.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Defaultuserquota
Type: objectDefault space quota for new users.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Devices
Type: objectControls whether device files can be opened.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Direct
Type: objectControls direct I/O behavior (standard or always).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Dnodesize
Type: objectControls dnode size for new objects.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Exec
Type: objectControls whether programs can be executed from filesystem.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Filesystem Count
Type: object(READ-ONLY): Count of child filesystems.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Filesystem Limit
Type: objectMaximum number of child filesystems allowed.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Longname
Type: objectControls support for long filenames.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Mounted
Type: object(READ-ONLY): Property indicating if filesystem is mounted.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Mountpoint
Type: objectControls mount point used for this filesystem.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Nbmand
Type: objectControls non-blocking mandatory locking behavior.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Normalization
Type: objectUnicode normalization property for filenames.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Overlay
Type: objectControls overlay mount behavior.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Quota
Type: objectLimits space consumed by dataset and descendants.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Recordsize
Type: objectMaximum block size for files in this filesystem.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Refquota
Type: objectLimits space consumed by dataset itself (no descendants).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Refreservation
Type: objectMinimum space reserved for volume itself.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Relatime
Type: objectControls relative access time updates.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Setuid
Type: objectControls setuid/setgid bit respect on executable files.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Snapdir
Type: objectControls snapshot directory visibility (hidden or visible).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Special Small Blocks
Type: objectSize threshold for storing blocks on special vdevs.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Utf8Only
Type: objectControls whether only UTF-8 filenames are allowed.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Version
Type: object(READ-ONLY): Filesystem version number.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Volmode
Type: objectControls volume mode (default, geom, dev, none).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Vscan
Type: objectControls virus scanning behavior.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Xattr
Type: objectControls extended attribute behavior (on, off, sa, dir).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Zoned
Type: objectControls whether filesystem is managed from a zone.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Available
Type: objectAmount of space available to dataset and its children.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Checksum
Type: objectControls checksum algorithm used to verify data integrity.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Compression
Type: objectControls compression algorithm used for this dataset.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Compressratio
Type: object(READ-ONLY): Property showing achieved compression ratio.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Context
Type: objectSELinux security context for the dataset.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Copies
Type: objectControls number of copies of data stored (1, 2, or 3).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Createtxg
Type: object(READ-ONLY): Transaction group when dataset was created.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Creation
Type: object(READ-ONLY): Timestamp when dataset was created.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Dedup
Type: objectControls data deduplication for the dataset.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Defcontext
Type: objectSELinux default security context for new files.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Encryption
Type: objectControls encryption cipher suite for the dataset.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Encryptionroot
Type: object(READ-ONLY): Property showing encryption root dataset.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Fscontext
Type: objectSELinux filesystem security context.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Guid
Type: object(READ-ONLY): Globally unique identifier for the dataset.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Keyformat
Type: objectEncryption key format (raw, hex, or passphrase).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Keylocation
Type: objectLocation where encryption key is stored.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Keystatus
Type: object(READ-ONLY): Encryption key status (available/unavailable).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Logbias
Type: objectControls ZIL write behavior (latency or throughput).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Logicalreferenced
Type: object(READ-ONLY): Logical space referenced by dataset.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Logicalused
Type: object(READ-ONLY): Logical space used by dataset and descendants.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Mlslabel
Type: objectMulti-level security label for the dataset.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Objsetid
Type: object(READ-ONLY): Object set identifier for the dataset.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Origin
Type: object(READ-ONLY): Snapshot this dataset was cloned from.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Pbkdf2Iters
Type: objectNumber of PBKDF2 iterations for key derivation.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Prefetch
Type: objectControls prefetch behavior (all, metadata, or none).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Primarycache
Type: objectControls primary cache usage (all, metadata, or none).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Readonly
Type: objectControls whether dataset can be modified.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Receive Resume Token
Type: object(READ-ONLY): Token for resuming interrupted zfs receive.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Redact Snaps
Type: object(READ-ONLY): List of redaction snapshots.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Redundant Metadata
Type: objectControls redundant metadata storage (all or most).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Refcompressratio
Type: object(READ-ONLY): Compression ratio for referenced data.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Referenced
Type: object(READ-ONLY): Space referenced by this dataset.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Reservation
Type: objectMinimum space reserved for dataset and descendants.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Rootcontext
Type: objectSELinux root directory security context.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Secondarycache
Type: objectControls secondary cache usage (all, metadata, or none).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Snapdev
Type: objectControls snapshot device visibility (hidden or visible).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Snapshot Count
Type: object(READ-ONLY): Count of snapshots in this dataset.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Snapshot Limit
Type: objectMaximum number of snapshots allowed.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Snapshots Changed
Type: object(READ-ONLY): Property indicating snapshot changes.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Sync
Type: objectControls synchronous write behavior (standard, always, disabled).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Type
(READ-ONLY): Type of ZFS dataset (filesystem, volume, etc).
PropertyValue
Type: objectNo Additional Properties
Raw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Used
Type: object(READ-ONLY): Space used by dataset and descendants.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Usedbychildren
Type: object(READ-ONLY): Space used by child datasets.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Usedbydataset
Type: object(READ-ONLY): Space used by this dataset itself.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Usedbyrefreservation
Type: object(READ-ONLY): Space used by refreservation.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Usedbysnapshots
Type: object(READ-ONLY): Space used by snapshots.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Written
Type: object(READ-ONLY): Space referenced since previous snapshot.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Volblocksize
Type: objectBlock size for volume (typically 8K or 16K).
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Volsize
Type: objectLogical size of the volume.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Volthreading
Type: objectControls volume threading behavior.
No Additional PropertiesRaw
Type: stringThe raw value of the property.
The source from where this property received its value.
Value
The parsed raw value of the property.
Type
Type: enum (of string)The type of ZFS resource.
Must be one of:
- "FILESYSTEM"
- "VOLUME"
User Properties
Custom metadata properties with colon-separated names (max 256 chars).
Each additional property must conform to the following schema
Type: stringChildren
The children of this zfs resource.
No Additional Items
Each item of this array must be:
Tier classification for FILESYSTEM resources. None if not requested, not applicable, or deduplication is enabled on the dataset.
TierInfo
Type: objectNo Additional Properties
Tier Type
Type: enum (of string)Storage performance tier for this share.
Must be one of:
- "REGULAR"
- "PERFORMANCE"
Most recent rewrite job for this share's dataset, or null if no job history exists.
ZfsTierRewriteJobEntry
Type: objectNo Additional Properties
Tier Job Id
Type: stringRewrite job identifier in dataset_name@job_uuid format.
Must be at least 1 characters long
Dataset Name
Type: stringZFS dataset this job is operating on.
Must be at least 1 characters long
Job Uuid
Type: stringUnique identifier for this rewrite job.
Must be at least 1 characters long
Status
Type: enum (of string)Current lifecycle state of the job.
COMPLETE- All files in the dataset have been processed.RUNNING- Job is actively processing files.QUEUED- Job is waiting for a free execution slot (seemax_concurrent_jobs).CANCELLED- Job was stopped viazfs_tier_job.cancel. Not resumable.STOPPED- Job was RUNNING but its process is no longer active (e.g. daemon restart). This state is computed on read and is never written to persistent storage.ERROR- Job halted due to an unrecoverable error. Usezfs_tier_job.recoverto retry failed files.
Must be one of:
- "COMPLETE"
- "RUNNING"
- "QUEUED"
- "CANCELLED"
- "STOPPED"
- "ERROR"
ZFSResourceListChangedEvent
Type: objectNo Additional Properties
Id
Type: stringPath of the filesystem or volume that changed.
ZFSResourceSetChange
Type: objectWhat the operation changed. Only the properties it touched are present.
No Additional PropertiesProperties
The native properties the operation set, inherited or derived, with their values as read back after the write. Properties it did not touch are absent.
Each additional property must conform to the following schema
PropertyValue
Type: objectNo Additional Properties
Raw
Type: stringThe raw value of the property.
The source from where this property received its value.
SourceValue
Type: objectNo Additional Properties
Type
Type: enum (of string)The source type.
Must be one of:
- "NONE"
- "DEFAULT"
- "TEMPORARY"
- "LOCAL"
- "INHERITED"
- "RECEIVED"
Value
The source value.
Value
The parsed raw value of the property.
User Properties
The user properties as read back after the write, named as zfs.resource.list names them. Null when the operation touched no user property.
Each additional property must conform to the following schema
Type: stringInherited
Type: array of stringThe property names the operation reset to their inherited value.
No Additional ItemsEach item of this array must be:
Descendants Affected
Type: booleanMeans an inherited property value below id may have changed. It does not cover space accounting: a quota set here changes the space available to every descendant without setting this flag.
ZFSResourceListRemovedEvent
Type: objectNo Additional Properties
Id
Type: stringPath of the filesystem or volume that was destroyed or renamed away.
Required roles: ZFS_RESOURCE_READ