orchestration: Add API docs for stack actions

Adds documentation for stack actions, currently we support two actions
suspend and resume, added to the API during the Havana cycle.

Change-Id: I1962e257029d0a75a80eb575e34c38b78da5872a