zfs – Manage zfs
Synopsis
- Manages ZFS file systems, volumes, clones and snapshots
 
Parameters
| Parameter | Choices/Defaults | Comments | 
|---|---|---|
|  extra_zfs_properties   -   added in 2.5   |    A dictionary of zfs properties to be set.  See the zfs(8) man page for more information.   |  |
|  key_value   -    |    (**DEPRECATED**) This will be removed in Ansible-2.9. Set these values in the  extra_zfs_properties option instead.The   zfs module takes key=value pairs for zfs properties to be set.See the zfs(8) man page for more information.   |  |
|  name   - / required    |    File system, snapshot or volume name e.g.   rpool/myfs. |  |
|  origin   -    |    Snapshot from which to create a clone.   |  |
|  state   - / required    |   
  |    Whether to create (  present), or remove (absent) a file system, snapshot or volume. All parents/children will be created/destroyed as needed to reach the desired state. |  
Examples
- name: Create a new file system called myfs in pool rpool with the setuid property turned off
  zfs:
    name: rpool/myfs
    state: present
    extra_zfs_properties:
      setuid: off
- name: Create a new volume called myvol in pool rpool.
  zfs:
    name: rpool/myvol
    state: present
    extra_zfs_properties:
      volsize: 10M
- name: Create a snapshot of rpool/myfs file system.
  zfs:
    name: rpool/myfs@mysnapshot
    state: present
- name: Create a new file system called myfs2 with snapdir enabled
  zfs:
    name: rpool/myfs2
    state: present
    extra_zfs_properties:
      snapdir: enabled
- name: Create a new file system by cloning a snapshot
  zfs:
    name: rpool/cloned_fs
    state: present
    origin: rpool/myfs@mysnapshot
- name: Destroy a filesystem
  zfs:
    name: rpool/myfs
    state: absent
   Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
 - This module is maintained by the Ansible Community. [community]
 
Authors
- Johan Wiren (@johanwiren)
 
Hint
If you notice any issues in this documentation you can edit this document to improve it.
    © 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
    https://docs.ansible.com/ansible/2.7/modules/zfs_module.html