pool.create =========== Create a new ZFS Pool. .. examples(websocket):: Create a pool named "tank", raidz1 with 3 disks, 1 cache disk, 1 ZIL/log disk and 1 hot spare disk. :::javascript { "id": "6841f242-840a-11e6-a437-00e04d680384", "msg": "method", "method": "pool.create", "params": [{ "name": "tank", "topology": { "data": [ {"type": "RAIDZ1", "disks": ["da1", "da2", "da3"]} ], "cache": [ {"type": "STRIPE", "disks": ["da4"]} ], "log": [ {"type": "RAIDZ1", "disks": ["da5"]} ], "spares": ["da6"] } }] } This method is a job. .. raw:: html
Configuration for creating a new storage pool.
No Additional PropertiesName for the new storage pool.
Must be at least 1 characters long
Must be at most 50 characters long
If set, create a ZFS encrypted root dataset for this pool.
How to manage the deduplication table quota allocation.
Custom quota value in bytes when dedup_table_quota is set to CUSTOM.
Value must be strictly greater than 0
Make sure no block of data is duplicated in the pool. If set to VERIFY and two blocks have similar signatures, byte-to-byte comparison is performed to ensure that the blcoks are identical. This should be used in special circumstances as it carries a significant overhead.
Checksum algorithm to use for data integrity verification.
Specify configuration for encryption of root dataset.
No Additional PropertiesAutomatically generate the key to be used for dataset encryption.
Number of PBKDF2 iterations for key derivation from passphrase. Higher iterations improve security against brute force attacks but increase unlock time. Default 350,000 balances security and performance.
Value must be greater or equal to 100000
Encryption algorithm to use for dataset encryption.
Must be specified if encryption for root dataset is desired with a passphrase as a key.
Must be at least 8 characters long
A hex-encoded key specified as an alternative to using passphrase.
Must be at least 64 characters long
Must be at most 64 characters long
Physical layout and configuration of vdevs in the pool.
No Additional Properties{
"cache": [
{
"disks": [
"da4"
],
"type": "STRIPE"
}
],
"data": [
{
"disks": [
"da1",
"da2",
"da3"
],
"type": "RAIDZ1"
}
],
"log": [
{
"disks": [
"da5"
],
"type": "STRIPE"
}
],
"spares": [
"da6"
]
}
All vdevs must be of the same type.
Must contain a minimum of 1 items
Type of distributed RAID configuration.
Array of disk names to use in this DRAID vdev.
No Additional ItemsDefaults to zfs.VDEV_DRAID_MAX_CHILDREN.
Number of distributed spare disks in the DRAID configuration.
Type of vdev configuration.
Array of disk names to use in this vdev.
No Additional ItemsArray of special vdev configurations for metadata storage.
No Additional ItemsType of distributed RAID configuration.
Array of disk names to use in this DRAID vdev.
No Additional ItemsDefaults to zfs.VDEV_DRAID_MAX_CHILDREN.
Number of distributed spare disks in the DRAID configuration.
Type of vdev configuration.
Array of disk names to use in this vdev.
No Additional ItemsArray of deduplication table vdev configurations.
No Additional ItemsType of deduplication table vdev configuration.
Array of disk names to use in this dedup vdev.
No Additional ItemsArray of L2ARC cache vdev configurations.
No Additional ItemsType of L2ARC cache vdev configuration (always stripe).
Specific value:"STRIPE"
Array of disk names to use in this cache vdev.
No Additional ItemsArray of ZFS Intent Log (ZIL) vdev configurations.
No Additional ItemsType of ZFS Intent Log (ZIL) vdev configuration.
Array of disk names to use in this log vdev.
No Additional ItemsArray of spare disk names for the pool.
No Additional ItemsWhether to allow disks with duplicate serial numbers in the pool.
When set, all disks in the pool must be SED based.
Information about the newly created pool.
No Additional PropertiesUnique identifier for this storage pool.
Name of the storage pool.
Globally unique identifier (GUID) for this pool.
Current status of the pool.
"ONLINE"
"DEGRADED"
"FAULTED"
Filesystem path where the pool is mounted.
Information about the most recent scrub or resilver operation. null if no scan data is available.
Type of ZFS pool scan.
Current lifecycle state of the scan.
Scan start time.
Scan end time (null while the scan is still running).
Scan progress (between 0 and 100%).
Total bytes located by scanner.
Total bytes to scan.
Issued bytes per scan pass.
Pause time of a scrub pass (null if the scan is not paused).
Number of scan errors.
Number of seconds left (null if the scan is not running).
Information about any active pool expansion operation. null if no expansion is running.
{
"bytes_reflowed": 978944,
"bytes_to_reflow": 835584,
"end_time": null,
"expanding_vdev": 0,
"percentage": 85.35564853556485,
"start_time": null,
"state": "FINISHED",
"total_secs_left": null,
"waiting_for_resilver": 0
}
Whether this pool has been upgraded to the latest feature flags.
Whether the pool is in a healthy state with no errors or warnings.
Whether the pool has warning conditions that require attention.
Detailed status code for the pool condition. null if not applicable.
Human-readable description of the pool status. null if not available.
Total size of the pool in bytes. null if not available.
Amount of space currently allocated in the pool in bytes. null if not available.
Amount of free space available in the pool in bytes. null if not available.
Amount of space being freed (in bytes) by ongoing operations. null if not available.
Size of the deduplication table in bytes. null if deduplication is not enabled.
Quota limit for the deduplication table. null if no quota is set.
Percentage of pool fragmentation as a string. null if not available.
Human-readable string representation of the pool size. null if not available.
Human-readable string representation of allocated space. null if not available.
Human-readable string representation of free space. null if not available.
Human-readable string representation of space being freed. null if not available.
Auto-trim configuration for the pool indicating whether automatic TRIM operations are enabled.
{
"parsed": "off",
"rawvalue": "off",
"source": "DEFAULT",
"value": "off"
}
Physical topology and structure of the pool including vdevs. null if not available.
Array of data vdev configurations in the pool.
No Additional ItemsArray of ZFS Intent Log (ZIL) vdev configurations.
No Additional ItemsArray of L2ARC cache vdev configurations.
No Additional ItemsArray of spare disk configurations.
No Additional ItemsArray of special vdev configurations for metadata.
No Additional ItemsArray of deduplication table vdev configurations.
No Additional Items