Improve documentation and testing for host maintenance API

Bugs closed: AURORA-318

Reviewed at https://reviews.apache.org/r/20285/