VM placement api docs

[Vernholio]

First draft of updates for new and existing endpoints, in support of the new Placement Groups service.