pool.attach

Attach a disk to an existing vdev in a pool, converting a striped vdev to a mirror or extending an existing mirror to an n-way mirror.

This operation will format the new disk, attach it to the target vdev, and wait for resilvering to complete if the target is a RAIDZ vdev undergoing expansion.

Locking behavior: - If another attach operation is already using the same disk, this call will fail immediately with EBUSY rather than queueing. - If another attach operation is running on the same pool (but with a different disk), this call will queue and wait for the previous operation to complete. - Operations on different pools with different disks can run concurrently.

This method is a job.

Type: object

Call parameters

Type: array
No Additional Items

Tuple Validation

Parameter 1: oid

oid

Type: integer

ID of the pool to attach a disk to.

Parameter 2: options

options

Type: object

Configuration for the disk attachment operation.

No Additional Properties

target_vdev Required

Target Vdev

Type: string

GUID or device name of the target vdev to attach to.

new_disk Required

New Disk

Type: string

Name of the new disk to attach.

allow_duplicate_serials

Allow Duplicate Serials

Type: boolean Default: false

Whether to allow attaching disks with duplicate serial numbers.

Return value

Result

Type: null

Returns null on successful disk attachment.

Required roles: POOL_WRITE