# zfs.tier.rewrite_job_query

Subscribe to ZFS rewrite job collection events (ADDED, CHANGED, REMOVED). On subscribe, sends ADDED for all existing jobs, then polls every 5 seconds and fires CHANGED when a job transitions state or REMOVED when it disappears.

This event is generated by a dynamic source. If you want to specify subscription params, subscribe to it using the name in the following format zfs.tier.rewrite_job_query:{“param”: “value”}

Type: object

##

#### ZfsTierRewriteJobQueryEventSourceArgs

Type: object

No arguments — subscribes to all rewrite job lifecycle events.

##

#### ZfsTierRewriteJobQueryEventSourceEvent

Type: object
No Additional Properties

##

#### ZfsTierRewriteJobQueryEventSourceEvent

Type: object
No Additional Properties

##

#### ZfsTierRewriteJobEntry

Type: object

Current job entry reflecting the latest lifecycle state.

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_READ