← Back to branch summary

~ubuntu-branches/ubuntu/saucy/nova/saucy-proposed

« back to all changes in this revision

Viewing changes to doc/source/api_ext/ext_virtual_interfaces.rst

  • Committer: Package Import Robot
  • Author(s): Chuck Short
  • Date: 2012-05-24 13:12:53 UTC
  • mfrom: (1.1.55)
  • Revision ID: package-import@ubuntu.com-20120524131253-ommql08fg1en06ut
Tags: 2012.2~f1-0ubuntu1
https://launchpad.net/bugs/907197
* New upstream release.
* Prepare for quantal:
  - Dropped debian/patches/upstream/0006-Use-project_id-in-ec2.cloud._format_image.patch
  - Dropped debian/patches/upstream/0005-Populate-image-properties-with-project_id-again.patch
  - Dropped debian/patches/upstream/0004-Fixed-bug-962840-added-a-test-case.patch
  - Dropped debian/patches/upstream/0003-Allow-unprivileged-RADOS-users-to-access-rbd-volumes.patch
  - Dropped debian/patches/upstream/0002-Stop-libvirt-test-from-deleting-instances-dir.patch
  - Dropped debian/patches/upstream/0001-fix-bug-where-nova-ignores-glance-host-in-imageref.patch 
  - Dropped debian/patches/0001-fix-useexisting-deprecation-warnings.patch
* debian/control: Add python-keystone as a dependency. (LP: #907197)
* debian/patches/kombu_tests_timeout.patch: Refreshed.
* debian/nova.conf, debian/nova-common.postinst: Convert to new ini
  file configuration
* debian/patches/nova-manage_flagfile_location.patch: Refreshed

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/source/api_ext/ext_virtual_interfaces.rst
1
 
The Virtual Interfaces Extension
2
 
=================================================================
3
 
About this Extension
4
 
--------------------
5
 
The Virtual Interfaces extension lets you view the virtual interfaces used in an instance.
6
 
 
7
 
To obtain current information 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/extensions.
8
 
 
9
 
Extension Overview
10
 
~~~~~~~~~~~~~~~~~~
11
 
 
12
 
Name
13
 
        Virtual Interfaces
14
 
        
15
 
Namespace
16
 
        http://docs.openstack.org/ext/virtual_interfaces/api/v1.1
17
 
 
18
 
Alias
19
 
        MID-VRT
20
 
        
21
 
Contact
22
 
        Name <ryu@midokura.jp>
23
 
        
24
 
Status
25
 
        Alpha
26
 
        
27
 
Extension Version
28
 
        v1.0 (2011-08-18)
29
 
 
30
 
Dependencies
31
 
        Compute API 1.1
32
 
        
33
 
Doc Link (PDF)
34
 
        http://
35
 
        
36
 
Doc Link (WADL)
37
 
        http://
38
 
        
39
 
Short Description
40
 
        This extension enables Virtual Interfaces capabilities for OpenStack Compute servers so that you know the interfaces for the virtual instances running in the cloud. 
41
 
 
42
 
Sample Query Responses
43
 
~~~~~~~~~~~~~~~~~~~~~~
44
 
 
45
 
As shown below, responses to an EXTENSION query in XML or JSON provide basic information about the extension. 
46
 
 
47
 
Extension Query Response: XML::
48
 
 
49
 
        <extensions>
50
 
        <extension name="VirtualInterfaces" 
51
 
        namespace="http://docs.openstack.org/ext/virtual_interfaces/api/v1.1" 
52
 
        alias="virtual_interfaces" updated="2011-08-17T00:00:00+00:00">
53
 
        <description>Virtual interface support</description>
54
 
        </extension>
55
 
        </extensions>
56
 
 
57
 
Extension Query Response: JSON::
58
 
 
59
 
{"extensions": [{"updated": "2011-08-17T00:00:00+00:00", "name": "VirtualInterfaces", "links": [], "namespace": "http://docs.openstack.org/ext/virtual_interfaces/api/v1.1", "alias": "virtual_interfaces", "description": "Virtual interface support"}]}
60
 
 
61
 
 
62
 
Document Change History
63
 
~~~~~~~~~~~~~~~~~~~~~~~
64
 
 
65
 
============= =====================================
66
 
Revision Date Summary of Changes
67
 
2011-09-16    Initial draft
68
 
2012-03-30    Reformat of content
69
 
============= =====================================
70
 
 
71
 
 
72
 
Summary of Changes
73
 
------------------
74
 
This extension to the OpenStack Compute API enables listing of Virtual Interfaces of running instances.
75
 
 
76
 
This support is provided by the addition of new actions.
77
 
 
78
 
New Actions
79
 
~~~~~~~~~~~
80
 
virtual_interfaces
81
 
 
82
 
New Faults
83
 
~~~~~~~~~~
84
 
None
85
 
 
86
 
New Headers
87
 
~~~~~~~~~~~
88
 
None
89
 
 
90
 
New Resources
91
 
~~~~~~~~~~~~~
92
 
None
93
 
 
94
 
New States
95
 
~~~~~~~~~~
96
 
None
97
 
 
98
 
Changes to the Cloud Servers Specification
99
 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
100
 
 
101
 
A new action added to the 4.3 Server Actions section. 
102
 
 
103
 
============= ==================
104
 
Verb          URI
105
 
POST          /servers/id/virtual_interfaces
106
 
============= ==================
107
 
 
108
 
Normal Response Code(s): 202
109
 
 
110
 
Error Response Code(s): computeFault (400, 500, …), serviceUnavailable (503), unauthorized (401), forbidden (403), badRequest (400), badMethod (405), overLimit (413), itemNotFound (404), badMediaType (415), buildInProgress (409)