openstack/nova - nova - OpenDev: Free Software Needs Free Tools

This fixes the last json reference warning which exist. It also trims
out the baremetal API calls that we don't support any more (we only
have the readonly proxy). That was erroneously added to the compute
API docs in refactors of api-site last cycle.
Change-Id: I08be639b610304049b0959902ed8876559111274

This remove the duplicate entry of os-networks/actions api ref
and add the action name in their content.
Part of bp:api-ref-in-rst
Change-Id: I3ca28793b6bcf390c8a2bfa1dfcf0213cf6bd428

This patch fix sample file path in all remaining api ref files.
Part of bp:api-ref-in-rst
Change-Id: I214b3a5bedea44cdfeba644ef3796938b709f4bf

This fix sample file path and status code of evacuate
Part of bp:api-ref-in-rst
Change-Id: I3bec0fcf622c0a1c85bbfea53283bd73fd613c75

This fix some content and sample file path for:
-os-keypairs
-os-migrations
-os-networks
Part of bp:api-ref-in-rst
Change-Id: I6ae6d38207c5a9552bab9a42b2800449e4ad040a

This patch fix sample files path for os-i* APIs
Part of bp:api-ref-in-rst
Change-Id: I0d8de9aaef7ffe5e0dfe09f38246b1f57ac814cb

* Add notes for API bug: update return string type's agent id
* Fix the parameters for create agent
* Fix the description of agent id in the update url.
Part of bp:api-ref-in-rst
Change-Id: I5c102ef8a08123089ec4a85dde5716eda12fb8c7

This fix sample file path and some satatus code for
-fixed ips
-floating ips
Part of bp:api-ref-in-rst
Change-Id: I33341d67e678f70b1a4feb9b39a14f5ac81e8c65

This fix all sample file path for
-os-aggregates
-os-certificates
-os-consoles
Part of bp:api-ref-in-rst
Change-Id: I949f3625b7bad4f316ee4b5723fba8e95a205afd

This commit adds remaining image and metadata API ref
and also correct the existing one with status code and
sample file name.
Part of bp:api-ref-in-rst
Change-Id: I9db88b0ad042501406d512e417440a1146027326

This fixes the samples references in the security group files,
commenting out 2 that don't exist at all.
This drops the warnings to 145 against current master.
Part of bp:api-ref-in-rst
Change-Id: I0cb9932dc54cdffcbd9eda274a06d708e87409d8

This fixes all the samples references in os-services to not throw
warnings.
Part of bp:api-ref-in-rst
Change-Id: I25b469352a4f99e34783eb31ea3b94e4d9971477

This fixes more api samples references which were autogenerated
incorrectly, and brings our api-ref warnings down to 175.
It also removes the os-volume-types API references, which turns out to
be a complete work of fiction, and never existed.
Part of bp:api-ref-in-rst
Change-Id: I1395c5e5986d8810ed91e9c9f132ec04f620497c

This patch fix API ref for correct sample files and status code
for below APIs
- os-hosts
- os-quota-sets
- os-fping
Part of bp:api-ref-in-rst
Change-Id: I7ecfe5adf4d8f1e9c767bac9194d9160f09fbee9

This patch fix API ref for correct sample files and status code
for below APIs
- os-cells
- os-cloudpipe
- server-action-shelve
Part of bp:api-ref-in-rst
Change-Id: I6292f78742d7bb50882e186c97e7966721037ba4

The api sample reference is not correct
fix incorrect return value.
1. servers-action-console-output.inc
2. servers-action-crash-dump.inc
Part of bp:api-ref-in-rst
Change-Id: Id0d946478a6a59f63f22117944309d3eb66013d3

This patch fix API ref for correct sample files and status code
for below APIs
- ips
- limits
- server metadata
- agents
Part of bp:api-ref-in-rst
Change-Id: I91b769eefde78381dc0feb6b5c8c6cf753203732

Heading for json response example is wrong,
it is json request instead of json response.
Part of bp:api-ref-in-rst
Change-Id: I709b2bf19520eb76e0264c358a2146bb0dbcee2b

HTTP 40X-50X are not normal response codes at all.
This patch removes them from api-ref.
Part of bp:api-ref-in-rst
Change-Id: I32a29c9e2a3d69720e3a88e17ba36fe45fa902d9

The api-ref os-baremetal-nodes doesn't contain normal status code,
so this patch adds it for explaining the normal opperation.
Part of bp:api-ref-in-rst
Change-Id: I1e1e9ee37b1a8c0511438fa9a2e447c7d8df8d0f

"Creates an aggregate" API supports multiple parameters on a request,
but api-ref doesn.t contain them at all This patch adds them.
The following JSON-Schema is for the API.
https://github.com/openstack/nova/blob/master/nova/api/openstack/compute/schemas/aggregates.py#L32
Part of bp:api-ref-in-rst
Change-Id: I3a58568662d21059bccdcf64cc30dbf3b706db58

This fixes the samples references for ``servers-actions.inc`` and
``servers-multiple-create.inc`` and drops the warnings count to 195.
Change-Id: Id9a2ae98f5ded9ab57bfd3af5fb18357df6bc1d2

This updates servers.inc which had a rough path during conversion. The
GET servers/details was lost entirely.
It updates a number of parameters to distinguish ones that are only in
the queries, as well as fixes references to short names that collided.
It updates the UPDATE call to only specify request parameters which
you can actually update.
It introduces the notation object.field for parameters that are
embedded in other objects. This is a new concept, but one way we can
clear up that the uuid in the parameter list is really networks.uuid.
It also deletes the old hand rolled servers.rst, which drops the
warnings count by nearly 100.
Part of bp:api-ref-in-rst
Change-Id: Ie7693a5888efa913118244a0837e6c0177965d48