The <Name of Extension> Extension
=================================================================

About this Extension
--------------------
Describe the extension.

Who will use it and what project's API is it for?

How can I find out more about it?

Are there pre-requisites prior to using it such as special hardware or configuration?

To obtain current information on the extensions available to you, issue an EXTENSION query on the OpenStack system where it is installed, such as http://mycloud.com/v1.1/tenant/etensions.


Extension Overview
~~~~~~~~~~~~~~~~~~

Name
    Name of Extensions

Namespace
    http://docs.openstack.org/<project>/api/ext/tla/v1.0

Alias
    ORG-EXT

Contact
    Name <email@mailingaddress.net>

Status
    Alpha, Beta, or Released

Extension Version
    v1.0 (year-mm-dd)

Dependencies
    Name and version of API

Doc Link (PDF)
    http://

Doc Link (WADL)
    http://

Short Description
    This extension enables ...

Sample Query Responses
~~~~~~~~~~~~~~~~~~~~~~

As shown below, responses to an EXTENSION query in XML or JSON provide basic information about the extension.

Extension Query Response: XML::

    N/A

Extension Query Response: JSON::


Document Change History
~~~~~~~~~~~~~~~~~~~~~~~

============= =====================================
Revision Date Summary of Changes
yyyy-mm-dd    Describe the change, one line per rev
============= =====================================


Summary of Changes
------------------
This extension to the <project> API allows ...

This support is provided by the addition of new <actions, faults, headers, resources, states, something else>.

New Actions
~~~~~~~~~~~
List each action in a section. Enter "None" if there are no changes.

Include the response codes, transitions if applicable, and XML and JSON examples.

New Faults
~~~~~~~~~~

New Headers
~~~~~~~~~~~

New Resources
~~~~~~~~~~~~~

New States
~~~~~~~~~~

Changes to the Cloud Servers Specification
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
List the specific changes to the API. For example:

In section 4.1.1 (List Servers) of the Cloud Servers Specification: Examples 4.1 and 4.2 should be replaced with Example 2.7 and Example 2.8 below.

Provide examples in XML and JSON




