add a status filter to get clusters call.
logging and doc fixes.
update rest api docs to include status filter.
check for empty list before accessing first element.
Merge pull request #504 from continuuity/feature/cluster-status-filter

add a status filter to get clusters call.