nova/api-ref/source/extensions.inc
ghanshyam f44d1aff9d Enable all extension for all remaining sample tests
As extensions options has been deprecated, API sample tests
should run against all extension enable.

This commit enables all extensions for all the remaining sample tests
and remove extensions specific tests and sample files.

Also remove extension setting specific logic from base test class
along with TODOs.

Partially implements blueprint api-sample-tests-with-all-extensions

Change-Id: I66b593760789e5b3b92137a672246f8d91e44cba
2016-06-10 06:03:02 +00:00

95 lines
2.2 KiB
ReStructuredText

.. -*- rst -*-
=====================================
Extensions (extensions) (DEPRECATED)
=====================================
Lists available extensions and shows information for an extension, by
alias.
Nova originally supported the concept of API extensions, that allowed
implementations of Nova to change the API (add new resources, or
attributes to existing resource objects) via extensions. In an attempt
to expose to the user what was supported in a particular site, the
extensions resource provided a list of extensions and detailed
information on each. The net result was gratuitous differentiation in
the API that required all users of OpenStack clouds to write specific
code to interact with every cloud.
As such, the entire extensions concept is deprecated, and will be
removed in the near future.
For information about extensions, see `Extensions
<http://developer.openstack.org/api-guide/compute/extensions.html>`__.
List Extensions
===============
.. rest_method:: GET /extensions
Lists all extensions to the API.
Normal response codes: 200
Error response codes: unauthorized(401)
Response
--------
.. rest_parameters:: parameters.yaml
- extensions: extensions
- name: extension_name
- alias: alias
- links: extension_links
- namespace: namespace
- description: extension_description
- updated: updated
**Example List Extensions**
Lists all extensions to the API.
.. literalinclude:: ../../doc/api_samples/extension-info/extensions-list-resp.json
:language: javascript
Show Extension Details
======================
.. rest_method:: GET /extensions/{alias}
Shows details for an extension, by alias.
Normal response codes: 200
Error response codes: unauthorized(401), itemNotFound(404)
Request
-------
.. rest_parameters:: parameters.yaml
- alias: alias
Response
--------
.. rest_parameters:: parameters.yaml
- extension: extension
- name: extension_name
- alias: alias
- links: extension_links
- namespace: namespace
- description: extension_description
- updated: updated
**Example Show Extension Details**
Shows details about the ``os-agents`` extension.
.. literalinclude:: ../../doc/api_samples/extension-info/extensions-get-resp.json
:language: javascript