Summary

In this pull request we're adding support for additional filtering options to the provisioners list CLI command and the /provisionerdaemons API endpoint.

Resolves: #18783

Changes

Added CLI Options

• --show-offline: When this option is provided, all provisioner daemons will be returned. This means that when --show-offline is not provided only idle and busy provisioner daemons will be returned.
• --status=<list_of_statuses>: When this option is provided with a comma-separated list of valid statuses (idle, busy, or offline) only provisioner daemons that have these statuses will be returned.
• --max-age=<duration>: When this option is provided with a valid duration value (e.g., 24h, 30s) only provisioner daemons with a last_seen_at timestamp within the provided max age will be returned.

Query Params

• ?offline=true: Include offline provisioner daemons in the results. Offline provisioner daemons will be excluded if ?offline=false or if offline is not provided.
• ?status=<list_of_statuses>: Include provisioner daemons with the specified statuses.
• ?max_age=<duration>: Include provisioner daemons with a last_seen_at timestamp within the max age duration.

Show Offline vs Offline Status

To list offline provisioner daemons, users can either:

1. Include the --show-offline option

OR

2. Include offline in the list of values provided to the --status option