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

os.popen() is deprecated since version 2.6. Resolved with use of
subprocess module.
Change-Id: Iea9c0501f46c57d809217912fb0f40eb2bc4f111
Closes-Bug: #1529836 

To help add color to the API doc, we use a common set of persona when
talking about the use cases behind each API.
This is really just a quick sketch that adds TODOs for others to follow
up on, in order to complete the guide.
blueprint complete-todo-in-api-concept-doc
Change-Id: I71a07caa27f1b17d3256a5439e867c40fc9d0abd

Common usage is REST, and most in project are written as REST.
Change ReST to REST to comply with it.
Change-Id: I2c87f4c811f7dd64a3f5807a45eba2a82373da36

This patch adds the concept guide for certificate.
blueprint complete-todo-in-api-concept-doc
Change-Id: If44e5f4633ee47d235e8254904d950e7d81d39c1

This document previously existed to explain how to use either
application/json or application/xml with Nova. It's mostly confusing
in it's current state, and we're correctly defaulting to
application/json on request and response now.
Just remove most of what's confusing, users don't need to send
headers, we only do one thing now.
Change-Id: I597aeab73f1075f400f053016b4ea7bda01893a5

XML API interface has been already removed from Nova completely,
and its description of the extension concept becomes meaningless now.
So this patch removes it.
A small amount of the JSON description is left. The details are
trimmed down, as we're actually trying to get people away from
extensions as a concept.
A big warning to that effect is added into the document.
Partially implements blueprint complete-todo-in-api-concept-doc
Change-Id: Icf8bf87f38733ba03cf5ce1225594b0b282fde56

there is no method on 'BAK extension appended with a time stamp'
if this comes from some Active engine, we should let active
engine to document it instead of generialize it in nova
blueprint complete-todo-in-api-concept-doc
Closes-Bug: 1525137
Change-Id: Ibb05dc57f9be81de335ca4935c4c7fa59971de13

nova allows injections of zip or binary files, the doc
should not say 'You cannot inject binary or zip files into a new build'
blueprint complete-todo-in-api-concept-doc
Change-Id: I09b80268545ea0071946aefd3a566441296436ec
Closes-Bug: 1525132

Add hypervisor brief description on its concept and
how nova offer the ability to admin to interact with it;
Also add description for migraitons.
There is a doc about aggregates, so put the link
in general_info.rst.
blueprint complete-todo-in-api-concept-doc
Change-Id: I61f6999be62e3e689ca9bf8b28b08f6a0b4aa9df

For compute-api set the launchpad project users report bugs
against to "nova". Users can report bugs using the "bug icon" that will
directly link to the launchpad project, it currently goes to
"openstack-manuals" which is wrong for this content.
This variable is used by openstackdocstheme 1.2.6.
Closes-Bug: #1524476
Change-Id: I08ba11bb1c5388bc4611cea581274ac5d724c8d9

We have multiple concepts for configuring guest os. This patch
adds separated section for them, just like the 'move servers' section.
blueprint complete-todo-in-api-concept-doc
Change-Id: Ibbffdb00d1529a386f338da4776eb614891731c8

We should describe extra specs and image properties in concept doc
This patch add separated section for it.
blueprint complete-todo-in-api-concept-doc
Change-Id: I092c15c82666eeb113485aee3ea878888d6eaf2d

No substantial changes; just wanted to make the text sound more like
native English.
blueprint complete-todo-in-api-concept-doc
Change-Id: I9ff48113bf709f63e3654a5851aa8d6853b519b5

As the folloing content of etc/nova/api-paste.ini, legacy v2
endpoint is /v2, not /v2.1.
 /v1.1: openstack_compute_api_v21_legacy_v2_compatible
 /v2: openstack_compute_api_v21_legacy_v2_compatible
 /v2.1: openstack_compute_api_v21
So this patch fixes the endpoint.
Partially implements blueprint complete-todo-in-api-concept-doc
Change-Id: I6d9346ced38f522c516778cadae217d1d5c9cff1

The concept doc should only talk about v2.1 API. This pach corrects them.
Also use the current API response instead of the old one and correct some
old reference link.
blueprint complete-todo-in-api-concept-doc
Change-Id: I90b39959a6a13f37ec0c03cf6f86943eba6c47d1

This patch adds generic description for microversions. We will write
more use-cases in later patches.
blueprint complete-todo-in-api-concept-doc
Change-Id: I600ad4186a38eaffbec38bb15b2de0146c076abf

There are variety like "admin" or "administrator" on api-guide,
so this patch makes these words consistent for the readability.
Partially implements blueprint complete-todo-in-api-concept-doc
Change-Id: Id0a9444e5d48f62d6d02114f8668761647c2dae0

There still have some important concept in the docs, this patch adds
more to it.
blueprint complete-todo-in-api-concept-doc
Change-Id: I231f298d2c7ffa0736028db27fe54691ac4bd201

Most parts contain "ReSTful HTTP service" instead of "ReSTful web
service". So this patch changes "ReSTful web service" for the word
consistency.
Partially implements blueprint complete-todo-in-api-concept-doc
Change-Id: I642ae649adad8f886bdb6bce979a1dd7d2430a80

This patch corrects the fault message format, and use an example which
existed in the real world.
blueprint complete-todo-in-api-concept-doc
Change-Id: I76706cca5a9fdcfa6c3e2c9d08aa8f94fb9471d8

This patch updates the API concept guide about services.
blueprint complete-todo-in-api-concept-doc
Change-Id: I9196cb6b700687d2a42d4bf32ecb02a7300a9475

There are two parts talk about error handling in nova api.
One is under general-info, and another one is under separated section
fault. This patch remove the empty one.
blueprint complete-todo-in-api-concept-doc
Change-Id: I4b9e79bf96fc5e8aa5a143f38a25e258a8be82f4

Added text to the 'Hosts' and 'Host Actions' sections.
Change-Id: Ie139810b97ab0a9bb96c928ffb794353c6f0c0ae

There isn't 'fault' field in the response of image API. So remove
image stuff from the faults section.
blueprint complete-todo-in-api-concept-doc
Change-Id: I79d2b4a3dc492b8410b649756057c2d824f19989

In the introduction to the guide, note that there is a single API for
both end users and operators.
blueprint complete-todo-in-api-concept-doc
Change-Id: I726d1f230c0090ca8890195f56167e19a18e4665