Corrects some inconsistencies in REST API spec

Changes ids in json examples to uuids.
Changes example for adding role to plan to contain name and version.
Changes /v2/clouds to /v2/plans.

Change-Id: Id242a877b38409978ef337a1e4f5cc5955b21b95
Merge "Corrects some inconsistencies in REST API spec"