💡 feat: Add --state and --queue filter for bk agent list

[facingfrost]

Is your feature request related to a problem?

During production, when host is down, agents will be paused to prevent jobs running on problematic queue.
We need to resume the agents in bulk after hosts are back in healthy state.
Thus we want to have a filter for --state and --queue for bk agent list command.
Example usage:

$ bk agent list --state paused
$ bk agent list --queue test-queue
$ bk agent list --state paused --queue test-queue

Describe the solution you'd like.

Add more filters for bk agent list command.

Describe alternatives you've considered.

No response

Additional context

No response

[JoeColeman95]

Hey @facingfrost,

Thanks for this suggestion! It's great 😄 I've just raised a PR for this now (which is linked to this issue). I've opted to go with --tags opposed to --queue as it allows filtering by other meta-data, too. In this case, you could use --tags queue=default, allowing you to also do something to the effect of --tags queue=default --tags os=linux or --tags queue=default,os=linux to further refine by agent tags (as this would be a AND operation).

From your suggestion of --state paused, we've also added --state with options of paused, running and idle.

Both filters will be client-side, however, due to the type of operation this is. However, this will be O(n), linear with the number of agents, so should be a relatively quick operation even at scale.