Add api to allow retrieving agent data

[plars]

Description

Add api to allow retrieving agent data

Resolved issues

Resolves CERTTF-246

Documentation

swagger docs and README updated

Tests

Unit test added

[omar-selo]

I've noticed CERTTF-246 mentions a query parameter ?identifier=<cid>. Is this no longer necessary or perhaps it's coming in a future PR?

[plars]

I've noticed CERTTF-246 mentions a query parameter ?identifier=<cid>. Is this no longer necessary or perhaps it's coming in a future PR?

My understanding of the problem at the time we wrote that, was that they simply wanted to see if it was in testflinger or not on the c3 machine details page. After more discussion, it sounds like what they actually want is to extend the search API in a way that allows them to also query for systems that are in testflinger and retrieve the list of valid queues for that device as well. So eventually the solution will likely look more like what we discussed at the sprint - where c3 knows everything about every device, and testflinger generates configs for devices based off that data rather than through cc-lab-manager. But that will take quite a bit of time to implement. For now, this gives us a way that we can bulk-import the necessary data about agents so that c3 has more awareness and can hopefully include this in search results.

[omar-selo]

Thanks for your detailed responses!