We have many microversions but we but we haven't kept the samples, docs,
and tests up to date with them.
Of the many microversions this patch will focus on the ones that have
updated the fields returned for volumes updating the docs, adding the
appropriate json samples, updating the tests, and updating the
contributor docs to highlight the need to keep these up to date.
Some convenience methods have been added to facilitate the testing:
- use_versions: class decorator that allows us to run the same tests
with different microversions, each using their respective json and
templates.
- override_mv: method decorator to change the microversion in a single
test.
- common_api_sample: context manager to use the base sample instead of a
microversion specific one.
Change-Id: Ide303685a4cd1477c319b36e67a3b05c8d129126
dab5df1747