zfs.resource.encryption.change_key ================================== Change the key or passphrase of an unlocked encryption root. A new hex key is stored by the system. Switching to a passphrase is refused when an encryption root below ``path`` uses a hex key, or when ``path`` is a pool holding the system dataset. Switching to a hex key is refused when a parent is encrypted with a passphrase. Example: .. code:: json {"path": "tank/secure", "generate_key": true} This method is a job. *This job CAN be used with file upload.* See :ref:`uploading-files`. .. raw:: html
Change key parameters.
No Additional PropertiesPath of the unlocked encryption root whose key is changed.
Must be at least 1 characters long
Generate a new random 64-character hex key.
Read a 64-character hex key from the input pipe.
Number of PBKDF2 iterations for key derivation from the passphrase. Only meaningful together with passphrase. Higher values improve resistance to brute force attacks but increase unlock time.
Value must be greater or equal to 1300000
A new passphrase of 8 to 512 characters. Passphrases are never stored by the system.
Must be at least 8 characters long
Must be at most 512 characters long
A new key of exactly 64 hexadecimal characters.
^[0-9a-fA-F]{64}$
Returns null once the key is changed.