added missing flavor-rxtx extention to api-ref page

bug: #1097363

Patchset adds explanation of rxtx to first line displayed
(rather than hiding it under details button).

Change-Id: I9ce3e99ad63176d63ff428eb120b997bfec7b60f
author: diane fleming
This commit is contained in:
Diane Fleming 2013-03-21 10:49:48 -05:00 committed by annegentle
parent f6f6f213dd
commit 13f00a90e9
15 changed files with 438 additions and 713 deletions

3
api-ref/.gitignore vendored Normal file
View File

@ -0,0 +1,3 @@
*.bak
*.DS_Store
target/

View File

@ -9,7 +9,9 @@
<copyright>
<year>2010-2013</year>
</copyright>
<legalnotice role="apache2"><para/></legalnotice>
<legalnotice role="apache2">
<para/>
</legalnotice>
</info>
<preface xml:id="Overview">
<title>OpenStack API Reference</title>
@ -98,8 +100,8 @@
</section>
<section xml:id="ext-os-server-password">
<title>Server Password</title>
<para>This extension retrieves and resets the encrypted
admin password set through metadata service.</para>
<para>This extension retrieves and resets the encrypted admin
password set through metadata service.</para>
<wadl:resources
href="../wadls/compute-api/src/ext/os-server-password.wadl"
xmlns:wadl="http://wadl.dev.java.net/2009/02"/>
@ -202,8 +204,8 @@
</section>
<section xml:id="os-ext-ips">
<title>Server IP Type</title>
<para>This extension shows the type of the
IPs assigned to an instance, either fixed or floating.</para>
<para>This extension shows the type of the IPs assigned to an
instance, either fixed or floating.</para>
<wadl:resources
href="../wadls/compute-api/src/ext/os-ext-ips.wadl"
xmlns:wadl="http://wadl.dev.java.net/2009/02"/>
@ -237,17 +239,29 @@
xmlns:wadl="http://wadl.dev.java.net/2009/02"/>
</section>
<section xml:id="ext-os-flavormanage">
<title>Flavor Management</title>
<title>Flavors Create and Delete</title>
<para>Creates and deletes flavors.</para>
<wadl:resources
href="../wadls/compute-api/src/ext/os-flavormanage.wadl"
xmlns:wadl="http://wadl.dev.java.net/2009/02"/>
</section>
<section xml:id="os-flavor-rxtx">
<title>Flavors with the rxtx_factor Extended Attribute</title>
<para>Creates a flavor, gets details for a specified flavor, and
lists details for available flavors. Includes the
<literal>rxtx_factor</literal> extended attribute, related
to configured bandwidth cap values. </para>
<wadl:resources
href="../wadls/compute-api/src/ext/os-flavor-rxtx.wadl"
xmlns:wadl="http://wadl.dev.java.net/2009/02"/>
</section>
<section xml:id="os-flavorextradata">
<title>Flavors - Extra Data</title>
<para>Returns extra attributes with flavor objects, including
<literal>swap</literal>, <literal>rxtx_factor</literal>, and
<literal>OS-FLV-EXT-DATA:ephemeral</literal>. </para>
<title>Flavors with Extended Attributes</title>
<para>Creates a flavor, gets details for a flavor, and
lists details for available flavors. Includes the
<literal>rxtx_factor</literal>,
<literal>OS-FLV-EXT-DATA:ephermeral</literal>, and
<literal>swap</literal> extended attributes.</para>
<wadl:resources
href="../wadls/compute-api/src/ext/os-flavorextradata.wadl"
xmlns:wadl="http://wadl.dev.java.net/2009/02"/>

View File

@ -1,5 +1,10 @@
<?xml version='1.0' encoding='UTF-8'?>
<flavor xmlns:atom="http://www.w3.org/2005/Atom" xmlns="http://docs.openstack.org/compute/api/v1.1" disk="0" vcpus="1" ram="512" name="m1.tiny" id="1" rxtx_factor="1.0">
<atom:link href="http://openstack.example.com/v2/openstack/flavors/1" rel="self"/>
<atom:link href="http://openstack.example.com/openstack/flavors/1" rel="bookmark"/>
</flavor>
<flavor xmlns:atom="http://www.w3.org/2005/Atom"
xmlns="http://docs.openstack.org/compute/api/v1.1" disk="0"
vcpus="1" ram="512" name="m1.tiny" id="1" rxtx_factor="1.0">
<atom:link
href="http://openstack.example.com/v2/openstack/flavors/1"
rel="self"/>
<atom:link href="http://openstack.example.com/openstack/flavors/1"
rel="bookmark"/>
</flavor>

View File

@ -1,23 +1,44 @@
<?xml version='1.0' encoding='UTF-8'?>
<flavors xmlns:atom="http://www.w3.org/2005/Atom" xmlns="http://docs.openstack.org/compute/api/v1.1">
<flavor disk="0" vcpus="1" ram="512" name="m1.tiny" id="1" rxtx_factor="1.0">
<atom:link href="http://openstack.example.com/v2/openstack/flavors/1" rel="self"/>
<atom:link href="http://openstack.example.com/openstack/flavors/1" rel="bookmark"/>
<flavors xmlns:atom="http://www.w3.org/2005/Atom"
xmlns="http://docs.openstack.org/compute/api/v1.1">
<flavor disk="0" vcpus="1" ram="512" name="m1.tiny" id="1"
rxtx_factor="1.0">
<atom:link
href="http://openstack.example.com/v2/openstack/flavors/1"
rel="self"/>
<atom:link href="http://openstack.example.com/openstack/flavors/1"
rel="bookmark"/>
</flavor>
<flavor disk="20" vcpus="1" ram="2048" name="m1.small" id="2" rxtx_factor="1.0">
<atom:link href="http://openstack.example.com/v2/openstack/flavors/2" rel="self"/>
<atom:link href="http://openstack.example.com/openstack/flavors/2" rel="bookmark"/>
<flavor disk="20" vcpus="1" ram="2048" name="m1.small" id="2"
rxtx_factor="1.0">
<atom:link
href="http://openstack.example.com/v2/openstack/flavors/2"
rel="self"/>
<atom:link href="http://openstack.example.com/openstack/flavors/2"
rel="bookmark"/>
</flavor>
<flavor disk="40" vcpus="2" ram="4096" name="m1.medium" id="3" rxtx_factor="1.0">
<atom:link href="http://openstack.example.com/v2/openstack/flavors/3" rel="self"/>
<atom:link href="http://openstack.example.com/openstack/flavors/3" rel="bookmark"/>
<flavor disk="40" vcpus="2" ram="4096" name="m1.medium" id="3"
rxtx_factor="1.0">
<atom:link
href="http://openstack.example.com/v2/openstack/flavors/3"
rel="self"/>
<atom:link href="http://openstack.example.com/openstack/flavors/3"
rel="bookmark"/>
</flavor>
<flavor disk="80" vcpus="4" ram="8192" name="m1.large" id="4" rxtx_factor="1.0">
<atom:link href="http://openstack.example.com/v2/openstack/flavors/4" rel="self"/>
<atom:link href="http://openstack.example.com/openstack/flavors/4" rel="bookmark"/>
<flavor disk="80" vcpus="4" ram="8192" name="m1.large" id="4"
rxtx_factor="1.0">
<atom:link
href="http://openstack.example.com/v2/openstack/flavors/4"
rel="self"/>
<atom:link href="http://openstack.example.com/openstack/flavors/4"
rel="bookmark"/>
</flavor>
<flavor disk="160" vcpus="8" ram="16384" name="m1.xlarge" id="5" rxtx_factor="1.0">
<atom:link href="http://openstack.example.com/v2/openstack/flavors/5" rel="self"/>
<atom:link href="http://openstack.example.com/openstack/flavors/5" rel="bookmark"/>
<flavor disk="160" vcpus="8" ram="16384" name="m1.xlarge" id="5"
rxtx_factor="1.0">
<atom:link
href="http://openstack.example.com/v2/openstack/flavors/5"
rel="self"/>
<atom:link href="http://openstack.example.com/openstack/flavors/5"
rel="bookmark"/>
</flavor>
</flavors>
</flavors>

View File

@ -1,9 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
<flavor xmlns="http://docs.openstack.org/compute/api/v1.1"
xmlns:OS-FLV-EXT-DATA="http://docs.openstack.org/compute/ext/flavor_extra_data/api/v1.1"
name="flavortest"
ram="1024"
vcpus="2"
disk="10"
id="100"
rxtx_factor="2.0" />
name="flavortest" ram="1024" vcpus="2" disk="10" id="100"
rxtx_factor="2.0"/>

View File

@ -1,5 +1,10 @@
<?xml version='1.0' encoding='UTF-8'?>
<flavor xmlns:atom="http://www.w3.org/2005/Atom" xmlns="http://docs.openstack.org/compute/api/v1.1" disk="10" vcpus="2" ram="1024" name="flavortest" id="100" rxtx_factor="2.0">
<atom:link href="http://openstack.example.com/v2/openstack/flavors/100" rel="self"/>
<atom:link href="http://openstack.example.com/openstack/flavors/100" rel="bookmark"/>
</flavor>
<flavor xmlns:atom="http://www.w3.org/2005/Atom"
xmlns="http://docs.openstack.org/compute/api/v1.1" disk="10"
vcpus="2" ram="1024" name="flavortest" id="100" rxtx_factor="2.0">
<atom:link
href="http://openstack.example.com/v2/openstack/flavors/100"
rel="self"/>
<atom:link href="http://openstack.example.com/openstack/flavors/100"
rel="bookmark"/>
</flavor>

View File

@ -0,0 +1,196 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- (C) 2013 OpenStack LLC., All Rights Reserved -->
<application xmlns="http://wadl.dev.java.net/2009/02"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:db="http://docbook.org/ns/docbook"
xmlns:csapi="http://docs.openstack.org/compute/api/v2"
xmlns:xsdxt="http://docs.rackspacecloud.com/xsd-ext/v1.0"
xmlns:common="http://docs.openstack.org/common/api/v1.0"
xmlns:wadl="http://wadl.dev.java.net/2009/02"
xmlns:atom="http://www.w3.org/2005/Atom"
targetNamespace="http://docs.openstack.org/compute/api/v2"
xsi:schemaLocation="http://docs.openstack.org/compute/api/v2
../xsd/api.xsd
http://docs.openstack.org/common/api/v1.0
../xsd/api-common.xsd
">
<resources base="https://servers.api.openstack.com">
<resource id="version" type="#VersionDetails" path="v2/">
<resource id="tenantID" path="{tenant_id}">
<param name="tenant_id" style="template"
type="xsd:string">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml"> The
ID for the tenant or account in a
multi-tenancy cloud. </p>
</doc>
</param>
<resource id="Flavors" path="flavors">
<method href="#createFlavor"/>
<resource path="{flavor_id}">
<param name="flavor_id" style="template">
<doc>
<p
xmlns="http://www.w3.org/1999/xhtml"
> The flavor ID. </p>
</doc>
</param>
<method href="#getFlavor"/>
</resource>
<resource path="detail">
<method href="#getFlavorDetails"/>
</resource>
</resource>
</resource>
</resource>
</resources>
<method name="POST" id="createFlavor">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">Creates a flavor.
Includes the rxtx_factor extended attribute. </p>
</wadl:doc>
<request>
<param style="plain" name="name" required="true">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">The name
for the new flavor.</p>
</doc>
</param>
<param style="plain" name="ram" required="true">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">The amount
of RAM, in MBs, for the flavor.</p>
</doc>
</param>
<param style="plain" name="vcpus" required="true">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">The
virtual CPUs, as a whole integer, for the
flavor.</p>
</doc>
</param>
<param style="plain" name="disk" required="true">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">The amount
of disk space, in GBs.</p>
</doc>
</param>
<param style="plain" name="id" required="true">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">The ID for
the flavor, which is a unique integer
value.</p>
</doc>
</param>
<param style="plain" name="rxtx_factor" required="true">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">Enables
you to override the bandwidth cap value, which
defaults to the bandwidth cap value for the
network to which the flavor is attached. The
new bandwidth cap is calculated by multiplying
the rxtx_factor valued that you specify by the
rxtx_base property for the network. </p>
</doc>
</param>
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code
href="../api_samples/os-flavor-rxtx/flavor-rxtx-post-req.json"
/>
</doc>
</representation>
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code
href="../api_samples/os-flavor-rxtx/flavor-rxtx-post-req.xml"
/>
</doc>
</representation>
</request>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code
href="../api_samples/os-flavor-rxtx/flavor-rxtx-post-resp.json"
/>
</doc>
</representation>
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code
href="../api_samples/os-flavor-rxtx/flavor-rxtx-post-resp.xml"
/>
</doc>
</representation>
</response>
</method>
<method name="GET" id="getFlavor">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">Gets details for a
specified flavor. Includes the rxtx_factor extended
attribute.</p>
</wadl:doc>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code
href="../api_samples/os-flavor-rxtx/flavor-rxtx-get-resp.json"
/>
</doc>
</representation>
</response>
<response status="200">
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code
href="../api_samples/os-flavor-rxtx/flavor-rxtx-get-resp.xml"
/>
</doc>
</representation>
</response>
</method>
<method name="GET" id="getFlavorDetails">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">Lists details for
available flavors. Includes the rxtx_factor extended
attribute.</p>
</wadl:doc>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code
href="../api_samples/os-flavor-rxtx/flavor-rxtx-list-resp.json"
/>
</doc>
</representation>
</response>
<response status="200">
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code
href="../api_samples/os-flavor-rxtx/flavor-rxtx-list-resp.xml"
/>
</doc>
</representation>
</response>
</method>
</application>

View File

@ -1,19 +1,20 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- (C) 2012 OpenStack LLC., All Rights Reserved -->
<!-- (C) 2012-2013 OpenStack LLC., All Rights Reserved -->
<application xmlns="http://wadl.dev.java.net/2009/02"
xmlns:xsdxt="http://docs.rackspacecloud.com/xsd-ext/v1.0"
xmlns:wadl="http://wadl.dev.java.net/2009/02"
xmlns:csapi="http://docs.openstack.org/compute/api/v1.1">
<resources base="https://servers.api.openstack.com">
<resource id="version" type="#VersionDetails" path="v2/">
<resource id="tenantID" path="{tenant_id}">
<param name="tenant_id" style="template" type="xsd:string">
<doc><p xmlns="http://www.w3.org/1999/xhtml">
The ID for the tenant or account in a multi-tenancy cloud.
</p></doc>
<param name="tenant_id" style="template"
type="xsd:string">
<doc><p xmlns="http://www.w3.org/1999/xhtml">The
ID for the tenant or account in a
multi-tenancy cloud. </p></doc>
</param>
<resource id="Flavors" path="flavors">
@ -21,9 +22,10 @@
<resource path="{flavor_id}">
<param name="flavor_id" style="template">
<doc><p xmlns="http://www.w3.org/1999/xhtml">
The ID of the flavor of interest to you.
</p></doc>
<doc><p
xmlns="http://www.w3.org/1999/xhtml"
>The ID of the flavor of interest
to you. </p></doc>
</param>
<method href="#getFlavor"/>
@ -31,69 +33,100 @@
</resource>
<resource path="detail">
<method href="#getFlavorsDetailed"/>
<method href="#getFlavorsDetails"/>
</resource>
</resource>
</resource>
</resource>
</resources>
<method name="POST" id="createFlavor">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">
Create a flavor with extra attributes.
</p>
<p xmlns="http://www.w3.org/1999/xhtml">Creates a flavor.
Includes the rxtx_factor, OS-FLV-EXT-DATA:ephermeral,
and swap extended attributes.</p>
</wadl:doc>
<request>
<param style="plain" name="swap" required="true">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">
Amount of swap disk space to allocate to a
server (in GB).
</p>
</doc>
<param style="plain" name="name" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">The name
for the flavor.</p></doc>
</param>
<param style="plain" name="ram" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">The
amount of RAM, in MBs, for the
flavor.</p></doc>
</param>
<param style="plain" name="vcpus" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">The
virtual CPUs, in a whole integer amount, for
the flavor.</p></doc>
</param>
<param style="plain" name="disk" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">The
amount of disk space, in GBs, for the
flavor.</p></doc>
</param>
<param style="plain" name="id" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">The ID, a
unique integer value, for the
flavor.</p></doc>
</param>
<param style="plain" name="rxtx_factor" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">
This property allows created servers to have a
different bandwidth cap than that defined
in the network they are attached to.
This factor is multiplied by the rxtx_base
property of the network.
</p></doc>
<doc><p xmlns="http://www.w3.org/1999/xhtml">Enables
you to override the bandwidth cap value, which
defaults to the bandwidth cap value for the
network to which the flavor is attached. The
new bandwidth cap is calculated by multiplying
the rxtx_factor valued that you specify by the
rxtx_base property for the network. </p></doc>
</param>
<param style="plain" name="OS-FLV-EXT-DATA:ephemeral"
required="true">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">
Size of secondary drive to attach to
a server (in GB).
</p>
<p xmlns="http://www.w3.org/1999/xhtml">The size
of secondary drive, in GBs, to attach to a
server. </p>
</doc>
</param>
<param style="plain" name="swap" required="true">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">The amount
of swap disk space, in GBs, to allocate to a
server. </p>
</doc>
</param>
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-post-req.json"/>
<xsdxt:code
href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-post-req.json"
/>
</doc>
</representation>
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-post-req.xml"/>
<xsdxt:code
href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-post-req.xml"
/>
</doc>
</representation>
</request>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-post-resp.json"/>
<xsdxt:code
href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-post-resp.json"
/>
</doc>
</representation>
<response status="200">
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-post-resp.xml"/>
<xsdxt:code
href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-post-resp.xml"
/>
</doc>
</representation>
</response>
@ -102,50 +135,56 @@
<method name="GET" id="getFlavor">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">
Describe a single flavor with extra attributes.
</p>
<p xmlns="http://www.w3.org/1999/xhtml">Gets details for a
specified flavor. Includes the rxtx_factor,
OS-FLV-EXT-DATA:ephermeral, and swap extended
attributes.</p>
</wadl:doc>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code
href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-get-resp.json"/>
<xsdxt:code
href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-get-resp.json"
/>
</doc>
</representation>
</response>
<response status="200">
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code
href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-get-resp.xml"/>
<xsdxt:code
href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-get-resp.xml"
/>
</doc>
</representation>
</response>
</method>
<method name="GET" id="getFlavorsDetailed">
<method name="GET" id="getFlavorsDetails">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">
List flavors with extra attributes.
</p>
<p xmlns="http://www.w3.org/1999/xhtml">Lists details for
available flavors. Includes the rxtx_factor,
OS-FLV-EXT-DATA:ephermeral, and swap extended
attributes.</p>
</wadl:doc>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code
href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-list-resp.json"/>
<xsdxt:code
href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-list-resp.json"
/>
</doc>
</representation>
</response>
<response status="200">
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code
href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-list-resp.xml"/>
<xsdxt:code
href="../api_samples/OS-FLV-EXT-DATA/flavors-extra-data-list-resp.xml"
/>
</doc>
</representation>
</response>
</method>
</application>

View File

@ -1,71 +1,91 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- (C) 2012 OpenStack LLC., All Rights Reserved -->
<!-- (C) 2012-2013 OpenStack LLC., All Rights Reserved -->
<application xmlns="http://wadl.dev.java.net/2009/02"
xmlns:xsdxt="http://docs.rackspacecloud.com/xsd-ext/v1.0"
xmlns:wadl="http://wadl.dev.java.net/2009/02">
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:db="http://docbook.org/ns/docbook"
xmlns:csapi="http://docs.openstack.org/compute/api/v2"
xmlns:xsdxt="http://docs.rackspacecloud.com/xsd-ext/v1.0"
xmlns:common="http://docs.openstack.org/common/api/v1.0"
xmlns:wadl="http://wadl.dev.java.net/2009/02"
xmlns:atom="http://www.w3.org/2005/Atom"
targetNamespace="http://docs.openstack.org/compute/api/v2"
xsi:schemaLocation="http://docs.openstack.org/compute/api/v2
../xsd/api.xsd
http://docs.openstack.org/common/api/v1.0
../xsd/api-common.xsd
">
<resources base="https://servers.api.openstack.com/">
<resource id="version" path="v2">
<resource id="tenant_id" path="{tenant_id}">
<param name="tenant_id" style="template">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">
The unique identifier of the tenant or account.
</p>
<p xmlns="http://www.w3.org/1999/xhtml">The
unique ID of the tenant or
account. </p>
</doc>
</param>
<resource id="flavors" path="flavors">
<method href="#createFlavor" />
<method href="#createFlavor"/>
<resource id="flavor" path="{flavor_id}">
<param name="flavor_id" style="template">
<doc><p xmlns="http://www.w3.org/1999/xhtml">
The unique identifier of the flavor.
</p></doc>
<doc><p
xmlns="http://www.w3.org/1999/xhtml"
>The flavor ID. </p></doc>
</param>
<method href="#deleteFlavor" />
<method href="#deleteFlavor"/>
</resource>
</resource>
</resource>
</resource>
</resource>
</resources>
<method name="POST" id="createFlavor">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">
Create a flavor.
<p xmlns="http://www.w3.org/1999/xhtml">Creates a flavor.
</p>
</wadl:doc>
<request>
<param style="plain" name="name" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">Enter a name for the new flavor you want to create</p></doc>
</param>
<param style="plain" name="ram" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">Enter a MB value for the amount of RAM for this flavor.</p></doc>
</param>
<param style="plain" name="vcpus" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">Enter a whole integer value for the virtual CPUs for the new flavor you want to create.</p></doc>
</param>
<param style="plain" name="disk" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">Enter a GB value for the amount of disk space.</p></doc>
</param>
<param style="plain" name="id" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">Enter a unique integer value for the identifier for the new flavor.</p></doc>
</param>
<representation mediaType="application/json">
<param style="plain" name="name" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">The
name for the new flavor.</p></doc>
</param>
<param style="plain" name="ram" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">The amount of RAM, in MBs, for this
flavor.</p></doc>
</param>
<param style="plain" name="vcpus" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">The virtual CPUs, in a whole integer amount, for
the new flavor.</p></doc>
</param>
<param style="plain" name="disk" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">The amount of disk
space, in GBs.</p></doc>
</param>
<param style="plain" name="id" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">The ID for
the new flavor, which is a unique integer value.</p></doc>
</param>
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="../api_samples/os-flavor-manage/flavor-create-post-req.json" />
<xsdxt:code
href="../api_samples/os-flavor-manage/flavor-create-post-req.json"
/>
</doc>
</representation>
<representation mediaType="application/xml">
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code href="../api_samples/os-flavor-manage/flavor-create-post-req.xml" />
<xsdxt:code
href="../api_samples/os-flavor-manage/flavor-create-post-req.xml"
/>
</doc>
</representation>
</request>
@ -73,12 +93,16 @@
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="../api_samples/os-flavor-manage/flavor-create-post-resp.json" />
<xsdxt:code
href="../api_samples/os-flavor-manage/flavor-create-post-resp.json"
/>
</doc>
</representation>
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code href="../api_samples/os-flavor-manage/flavor-create-post-resp.xml" />
<xsdxt:code
href="../api_samples/os-flavor-manage/flavor-create-post-resp.xml"
/>
</doc>
</representation>
</response>
@ -86,16 +110,18 @@
<method name="DELETE" id="deleteFlavor">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">Delete a flavor.</p>
<p xmlns="http://www.w3.org/1999/xhtml">Deletes a
flavor.</p>
</wadl:doc>
<response status="204" />
<response status="204"/>
</method>
<method name="GET" id="listFlavors">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">List available flavors.</p>
<p xmlns="http://www.w3.org/1999/xhtml">Lists available
flavors.</p>
</wadl:doc>
<response status="200" />
<response status="200"/>
</method>

View File

@ -1,84 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- (C) 2012 OpenStack LLC., All Rights Reserved -->
<application xmlns="http://wadl.dev.java.net/2009/02"
xmlns:xsdxt="http://docs.rackspacecloud.com/xsd-ext/v1.0"
xmlns:wadl="http://wadl.dev.java.net/2009/02">
<resources base="https://servers.api.openstack.com/">
<resource id="version" path="v1.1">
<resource id="tenant_id" path="{tenant_id}">
<param name="tenant_id" style="template">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">
The unique identifier of the tenant or account.
</p>
</doc>
</param>
<resource id="flavors" path="flavors">
<method href="#createFlavor" />
<resource id="flavor" path="{flavor_id}">
<param name="flavor_id" style="template">
<doc><p xmlns="http://www.w3.org/1999/xhtml">
The unique identifier of the flavor.
</p></doc>
</param>
<method href="#deleteFlavor" />
</resource>
</resource>
</resource>
</resource>
</resources>
<method name="POST" id="createFlavor">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">
Create a flavor.
</p>
</wadl:doc>
<request>
<param style="plain" name="name" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">Enter a name for the new flavor you want to create</p></doc>
</param>
<param style="plain" name="ram" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">Enter a MB value for the amount of RAM for this flavor.</p></doc>
</param>
<param style="plain" name="vcpus" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">Enter a whole integer value for the virtual CPUs for the new flavor you want to create.</p></doc>
</param>
<param style="plain" name="disk" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">Enter a GB value for the amount of disk space.</p></doc>
</param>
<param style="plain" name="id" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">Enter a unique integer value for the identifier for the new flavor.</p></doc>
</param>
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/os-flavormanage-request.json" />
</doc>
</representation>
</request>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/os-flavormanage-response.json" />
</doc>
</representation>
</response>
</method>
<method name="DELETE" id="deleteFlavor">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">Delete a flavor.</p>
</wadl:doc>
<response status="204" />
</method>
</application>

View File

@ -1,147 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- (C) 2012 OpenStack LLC., All Rights Reserved -->
<application xmlns="http://wadl.dev.java.net/2009/02"
xmlns:xsdxt="http://docs.rackspacecloud.com/xsd-ext/v1.0"
xmlns:wadl="http://wadl.dev.java.net/2009/02">
<resources base="https://servers.api.openstack.com">
<resource id="version" type="#VersionDetails" path="v1.1">
<resource id="tenant_id" path="{tenant_id}">
<param name="tenant_id" style="template">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">
The unique identifier of the tenant or account.
</p>
</doc>
</param>
<resource id="os-floating-ip-dns" path="os-floating-ip-dns">
<method href="#ListDomains" />
<resource path="{domain}">
<param name="domain" style="template" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">
Registered DNS Domain published by the DNS drivers.
</p></doc>
</param>
<method href="#CreateDomain" />
<method href="#DeleteDomain" />
<resource id="entries" path="entries">
<resource path="{name}">
<param name="name" style="template" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">
DNS entry name assigned under a domain.
</p></doc>
</param>
<method href="#CreateEntry" />
<method href="#FindUniqueEntry" />
<method href="#DeleteEntry" />
</resource>
<resource path="{ip}">
<method href="#FindEntriesbyIP" />
</resource>
</resource>
</resource>
</resource>
</resource>
</resource>
</resources>
<method name="GET" id="ListDomains">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN" title="List DNS Domains">
<p xmlns="http://www.w3.org/1999/xhtml">Get a list of registered DNS Domains published by the DNS drivers.</p>
</wadl:doc>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/floating_ip_dns_list_response.json" />
</doc>
</representation>
</response>
</method>
<method name="PUT" id="CreateDomain">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN" title="Create a Domain">
<p xmlns="http://www.w3.org/1999/xhtml">Create or modify a DNS domain.</p>
</wadl:doc>
<request>
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/floating_ip_dns_create_domain_request.json" />
</doc>
</representation>
</request>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/floating_ip_dns_create_domain_response.json" />
</doc>
</representation>
</response>
</method>
<method name="DELETE" id="DeleteDomain">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN" title="Delete a Domain">
<p xmlns="http://www.w3.org/1999/xhtml">Delete a DNS domain and all associated host entries.</p>
</wadl:doc>
<response status="200" />
</method>
<method name="PUT" id="CreateEntry">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN" title="Create DNS Entry">
<p xmlns="http://www.w3.org/1999/xhtml">Create or modify a DNS entry.</p>
</wadl:doc>
<request>
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/floating_ip_dns_create_dns_request.json" />
</doc>
</representation>
</request>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/floating_ip_dns_create_dns_response.json" />
</doc>
</representation>
</response>
</method>
<method name="GET" id="FindUniqueEntry">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN" title="Find Unique DNS Entry">
<p xmlns="http://www.w3.org/1999/xhtml">Find unique DNS entry for a given domain and name.</p>
</wadl:doc>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/floating_ip_dns_finduniqentry_response.json" />
</doc>
</representation>
</response>
</method>
<method name="GET" id="FindEntriesbyIP">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN" title="Find DNS Entries">
<p xmlns="http://www.w3.org/1999/xhtml">Find DNS entries for a given domain and IP.</p>
</wadl:doc>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/floating_ip_dns_findentries_response.json" />
</doc>
</representation>
</response>
</method>
<method name="DELETE" id="DeleteEntry">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN" title="Delete a DNS entry">
<p xmlns="http://www.w3.org/1999/xhtml">Delete a DNS entry.</p>
</wadl:doc>
<response status="200" />
</method>
</application>

View File

@ -1,44 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- (C) 2012 OpenStack LLC., All Rights Reserved -->
<application xmlns="http://wadl.dev.java.net/2009/02"
xmlns:xsdxt="http://docs.rackspacecloud.com/xsd-ext/v1.0"
xmlns:wadl="http://wadl.dev.java.net/2009/02">
<resources base="https://floatingippools.example.com/">
<resource id="version" path="v1.1">
<resource id="tenant_id" path="{tenant_id}">
<param name="tenant_id" style="template">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">
The unique identifier of the tenant or account.
</p>
</doc>
</param>
<resource id="floating-ip-pools" path="os-floating-ip-pools">
<method href="#listFloatingIpPools" />
</resource>
</resource>
</resource>
</resources>
<method name="GET" id="listFloatingIpPools">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN"
title="List Floating IP Pools">
<p xmlns="http://www.w3.org/1999/xhtml">
View a list of Floating IP Pools.
</p>
</wadl:doc>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/floating_ip_pools_list.json" />
</doc>
</representation>
</response>
</method>
</application>

View File

@ -1,102 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- (C) 2012 OpenStack LLC., All Rights Reserved -->
<application xmlns="http://wadl.dev.java.net/2009/02"
xmlns:xsdxt="http://docs.rackspacecloud.com/xsd-ext/v1.0"
xmlns:wadl="http://wadl.dev.java.net/2009/02">
<resources base="https://servers.api.openstack.com">
<resource id="version" type="#VersionDetails" path="v1.1">
<resource id="tenant_id" path="{tenant_id}">
<param name="tenant_id" style="template">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">
The unique identifier of the tenant or account.
</p>
</doc>
</param>
<resource id="os-floating-ips" path="os-floating-ips">
<method href="#ListFloatingIPs" />
<method href="#AllocateFloatingIP" />
<resource path="{id}">
<param name="id" style="template" required="true">
<doc><p xmlns="http://www.w3.org/1999/xhtml">
The unique identifier associated with allocated floating IP address.
</p></doc>
</param>
<method href="#DetailFloatingIP" />
<method href="#DeallocateFloatingIP" />
</resource>
</resource>
</resource>
</resource>
</resources>
<method name="GET" id="ListFloatingIPs">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN" title="List Floating IPs">
<p xmlns="http://www.w3.org/1999/xhtml">Lists floating IP addresses associated with the tenant or account.</p>
</wadl:doc>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/list_floating_ips.json" />
</doc>
</representation>
</response>
</method>
<method name="POST" id="AllocateFloatingIP">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN" title="Allocate Floating IP">
<p xmlns="http://www.w3.org/1999/xhtml">Allocate a new floating IP address to a tenant or account.</p>
</wadl:doc>
<request>
<param name="pool" style="plain">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">
Pool to allocate ip from. Will use default pool if not specified.
</p>
</doc>
</param>
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/allocate_floating_ip_request.json" />
</doc>
</representation>
</request>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/allocate_floating_ip_response.json" />
</doc>
</representation>
</response>
<response status="400"><doc xml:lang="EN"><p xmlns="http://www.w3.org/1999/xhtml">If there are no floating IPs available, the
extension returns an error code 400 with a message indicating that no more floating IPs are available.</p></doc></response>
</method>
<method name="GET" id="DetailFloatingIP">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN" title="List Floating IP Detail">
<p xmlns="http://www.w3.org/1999/xhtml">Lists details of the floating IP address associated with floating_IP_address_ID.</p>
</wadl:doc>
<response status="200">
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/floating_ip_detail.json" />
</doc>
</representation>
</response>
</method>
<method name="DELETE" id="DeallocateFloatingIP">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN" title="Deallocate Floating IP">
<p xmlns="http://www.w3.org/1999/xhtml">Deallocates the floating IP address associated with floating_IP_address_ID.</p>
</wadl:doc>
<response status="202" />
</method>
</application>

View File

@ -1,204 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- (C) 2012 OpenStack LLC., All Rights Reserved -->
<application xmlns="http://wadl.dev.java.net/2009/02"
xmlns:xsdxt="http://docs.rackspacecloud.com/xsd-ext/v1.0"
xmlns:wadl="http://wadl.dev.java.net/2009/02">
<resources base="https://servers.api.openstack.com/">
<resource id="version" path="v1.1">
<resource id="tenant_id" path="{tenant_id}">
<param name="tenant_id" style="template">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">
The unique identifier of the tenant or account.
</p>
</doc>
</param>
<resource id="security_groups" path="os-security-groups">
<method href="#listSecGroups" />
<method href="#createSecGroup" />
<resource id="get_security_group" path="{security_group_id}">
<param name="security_group_id" style="template">
<doc><p xmlns="http://www.w3.org/1999/xhtml">
The unique identifier of the security group.
</p></doc>
</param>
<method href="#getSecGroup" />
<method href="#deleteSecGroup" />
</resource>
</resource>
<resource id="security_groups" path="os-security-group-rules">
<method href="#createSecGroupRule" />
<resource path="{security_group_rule_id}">
<param name="security_group_rule_id" style="template">
<doc><p xmlns="http://www.w3.org/1999/xhtml">
The unique identifier of the security group rule.
</p></doc>
</param>
<method href="#deleteSecGroupRule" />
</resource>
</resource>
<resource id="Servers" path="servers">
<resource path="{server_id}">
<param name="server_id" style="template" type="csapi:UUID">
<doc>
<p xmlns="http://www.w3.org/1999/xhtml">
The UUID for the server of interest to you.
</p>
</doc>
</param>
<resource path="os-security-groups">
<method href="#listSecGroupsByServer"/>
</resource>
</resource>
</resource>
</resource>
</resource>
</resources>
<method name="GET" id="listSecGroups">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">List security groups.</p>
</wadl:doc>
<response status="200">
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code href="samples/security_groups_list.xml" />
</doc>
</representation>
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/security_groups_list.json" />
</doc>
</representation>
</response>
</method>
<method name="GET" id="listSecGroupsByServer">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">
List security groups for a specific server.
</p>
</wadl:doc>
<response status="200">
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code href="samples/security_groups_list.xml" />
</doc>
</representation>
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/security_groups_list.json" />
</doc>
</representation>
</response>
</method>
<method name="GET" id="getSecGroup">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">
Get specific security group.
</p>
</wadl:doc>
<response status="200">
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code href="samples/security_group_get.xml" />
</doc>
</representation>
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/security_group_get.json" />
</doc>
</representation>
</response>
</method>
<method name="POST" id="createSecGroup">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">
Create a new security group.
</p>
</wadl:doc>
<request>
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code href="samples/security_group_create_request.xml" />
</doc>
</representation>
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/security_group_create_request.json" />
</doc>
</representation>
</request>
<response status="200">
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code href="samples/security_group_create.xml" />
</doc>
</representation>
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/security_group_create.json" />
</doc>
</representation>
</response>
</method>
<method name="DELETE" id="deleteSecGroup">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">Delete a security group.</p>
</wadl:doc>
<response status="202" />
</method>
<method name="POST" id="createSecGroupRule">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">
Create security group rule.
</p>
</wadl:doc>
<request>
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/security_group_rule_create_request.json" />
</doc>
</representation>
</request>
<response status="200">
<representation mediaType="application/xml">
<doc xml:lang="EN">
<xsdxt:code href="samples/security_group_rule_create.xml" />
</doc>
</representation>
<representation mediaType="application/json">
<doc xml:lang="EN">
<xsdxt:code href="samples/security_group_rule_create.json" />
</doc>
</representation>
</response>
</method>
<method name="DELETE" id="deleteSecGroupRule">
<wadl:doc xmlns="http://www.w3.org/1999/xhtml" xml:lang="EN">
<p xmlns="http://www.w3.org/1999/xhtml">
Delete security group rule.
</p>
</wadl:doc>
<response status="202" />
</method>
</application>

View File

@ -21,6 +21,7 @@
xmlns:common="http://docs.openstack.org/common/api/v1.0"
xmlns:wadl="http://wadl.dev.java.net/2009/02"
xmlns:atom="http://www.w3.org/2005/Atom"
targetNamespace="http://docs.openstack.org/compute/api/v2"
xsi:schemaLocation="http://docs.openstack.org/compute/api/v2
xsd/api.xsd
http://docs.openstack.org/common/api/v1.0