zfs.tier.rewrite_job_recover

Recover a rewrite job in ERROR state by reissuing failed rewrites.

Type: object

Type: array
No Additional Items

Tuple Validation

Parameter 1: zfs_tier_rewrite_job_recover

zfs_tier_rewrite_job_recover

Type: object

ZfsTierRewriteJobRecoverArgs parameters.

 No Additional Properties

Tier Job Id

Type: string

Rewrite job to recover, in dataset_name@job_uuid format. The job must be in ERROR state.

Must be at least 1 characters long

ZfsTierRewriteJobEntry

Type: object

The job after recovery is initiated. Status will be RUNNING if failed files remain to be retried, or COMPLETE if all previously failed files were retried successfully.

 No Additional Properties

Tier Job Id

Type: string

Rewrite job identifier in dataset_name@job_uuid format.

Must be at least 1 characters long

Dataset Name

Type: string

ZFS dataset this job is operating on.

Must be at least 1 characters long

Job Uuid

Type: string

Unique identifier for this rewrite job.

Must be at least 1 characters long

Status

Type: enum (of string)

Current lifecycle state of the job.

  • COMPLETE - All files in the dataset have been processed.
  • RUNNING - Job is actively processing files.
  • QUEUED - Job is waiting for a free execution slot (see max_concurrent_jobs).
  • CANCELLED - Job was stopped via zfs_tier_job.cancel. Not resumable.
  • STOPPED - Job was RUNNING but its process is no longer active (e.g. daemon restart). This state is computed on read and is never written to persistent storage.
  • ERROR - Job halted due to an unrecoverable error. Use zfs_tier_job.recover to retry failed files.
Must be one of:
  • "COMPLETE"
  • "RUNNING"
  • "QUEUED"
  • "CANCELLED"
  • "STOPPED"
  • "ERROR"


Required roles: DATASET_WRITE