zfs.resource.snapshot.create ============================ Create a ZFS snapshot. Args: data: Create parameters containing: - dataset: Dataset path to snapshot (e.g., 'pool/dataset'). - name: Snapshot name (the part after @). - recursive: Create snapshots recursively for child datasets. - exclude: Datasets to exclude when creating recursive snapshots. - user_properties: User properties to set on the snapshot. Returns: Snapshot entry for the created snapshot. Raises: ValidationError: If dataset not found or snapshot already exists. Examples: # Create a single snapshot create({"dataset": "tank/data", "name": "backup"}) # Create recursive snapshots create({ "dataset": "tank", "name": "backup", "recursive": True }) # Create with user properties create({ "dataset": "tank/data", "name": "backup", "user_properties": {"com.company:backup_type": "daily"} }) .. raw:: html
Create parameters for creating ZFS snapshots.
No Additional PropertiesDataset path to snapshot (e.g., 'pool/dataset').
Must be at least 1 characters long
Snapshot name (the part after @).
Must be at least 1 characters long
Create snapshots recursively for child datasets.
Datasets to exclude when creating recursive snapshots.
No Additional ItemsUser properties to set on the snapshot. Only user-defined properties are
supported (e.g., 'com.company:backup_type'). Regular ZFS properties cannot
be set on snapshots at creation time.
Each additional property must conform to the following schema
Type: stringThe TXG in which the snapshot was created.
A GUID for the snapshot.
The zfs resource for the given snapshot.
The zpool of the snapshot.
The zfs resource for the given snapshot.
The name of the snapshot.
The type of zfs resource.
Specific value:"SNAPSHOT"
A list of tags that hold the snapshot.
Requested properties for the snapshot.
(READ-ONLY): Type of ZFS dataset (filesystem, volume, etc).
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The source type.
The source value.
The parsed raw value of the property.
(READ-ONLY): Timestamp when dataset was created.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
(READ-ONLY): Space used by dataset and descendants.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
(READ-ONLY): Space referenced by this dataset.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
(READ-ONLY): Property showing achieved compression ratio.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
(READ-ONLY): Transaction group when dataset was created.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
(READ-ONLY): Globally unique identifier for the dataset.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Controls primary cache usage (all, metadata, or none).
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Controls secondary cache usage (all, metadata, or none).
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
(READ-ONLY): Object set identifier for the dataset.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Multi-level security label for the dataset.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
(READ-ONLY): Compression ratio for referenced data.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
(READ-ONLY): Space referenced since previous snapshot.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
(READ-ONLY): Logical space referenced by dataset.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
SELinux security context for the dataset.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
SELinux filesystem security context.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
SELinux default security context for new files.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
SELinux root directory security context.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Controls encryption cipher suite for the dataset.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
(READ-ONLY): Property showing encryption root dataset.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
(READ-ONLY): Encryption key status (available/unavailable).
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
(READ-ONLY): List of redaction snapshots.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Controls prefetch behavior (all, metadata, or none).
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Controls whether device files can be opened.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Controls whether programs can be executed from filesystem.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Controls setuid/setgid bit respect on executable files.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Controls extended attribute behavior (on, off, sa, dir).
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
(READ-ONLY): Filesystem version number.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Controls whether only UTF-8 filenames are allowed.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Unicode normalization property for filenames.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Determines filename matching algorithm sensitivity.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Controls non-blocking mandatory locking behavior.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Specifies type of ACL to use (off, nfsv4, posix).
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Default space quota for new users.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Default space quota for new groups.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Default space quota for new projects.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Default object quota for new users.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Default object quota for new groups.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Default object quota for new projects.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
Logical size of the volume.
No Additional PropertiesThe raw value of the property.
The source from where this property received its value.
The parsed raw value of the property.
User-defined properties for snapshots.
Each additional property must conform to the following schema
Type: string