Document Heat snapshot operations

Add API documentation to the new Heat snapshot operations with sample
responses.

Change-Id: I3fc74035ca91853df7b79920cd23da0f9bf24144
Merge "Document Heat snapshot operations"