79807e11a1
From RFC2606: To reduce the likelihood of conflict and confusion, a few top level domain names are reserved for use in private testing, as examples in documentation, and the like. Currently the documentation contains URLs that point to mycloud.com, which is registered and not affiliated with OpenStack. It's better to use example.com which exists for this purpose. Change-Id: I7ebd9b2c0d650f15e5924798cc54611d47961f8f
103 lines
2.7 KiB
ReStructuredText
103 lines
2.7 KiB
ReStructuredText
About The Virtual Interfaces Extension
|
|
======================================
|
|
The Virtual Interfaces extension lets you view the virtual interfaces used in an instance.
|
|
|
|
To obtain current information the extensions available to you, issue an EXTENSION query on the OpenStack system where it is installed, such as http://example.com/v1.1/tenant/extensions.
|
|
|
|
Virtual Interfaces Extension Overview
|
|
-------------------------------------
|
|
|
|
Name
|
|
Virtual Interfaces
|
|
|
|
Namespace
|
|
http://docs.openstack.org/ext/virtual_interfaces/api/v1.1
|
|
|
|
Alias
|
|
MID-VRT
|
|
|
|
Contact
|
|
Name <ryu@midokura.jp>
|
|
|
|
Status
|
|
Alpha
|
|
|
|
Extension Version
|
|
v1.0 (2011-08-18)
|
|
|
|
Dependencies
|
|
Compute API 1.1
|
|
|
|
Doc Link (PDF)
|
|
http://
|
|
|
|
Doc Link (WADL)
|
|
http://
|
|
|
|
Short Description
|
|
This extension enables Virtual Interfaces capabilities for OpenStack Compute servers so that you know the interfaces for the virtual instances running in the cloud.
|
|
|
|
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::
|
|
|
|
<extensions>
|
|
<extension name="VirtualInterfaces"
|
|
namespace="http://docs.openstack.org/ext/virtual_interfaces/api/v1.1"
|
|
alias="virtual_interfaces" updated="2011-08-17T00:00:00+00:00">
|
|
<description>Virtual interface support</description>
|
|
</extension>
|
|
</extensions>
|
|
|
|
Extension Query Response: JSON::
|
|
|
|
{"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"}]}
|
|
|
|
Document Change History
|
|
-----------------------
|
|
|
|
============= =====================================
|
|
Revision Date Summary of Changes
|
|
2011-09-16 Initial draft
|
|
============= =====================================
|
|
|
|
Summary of Changes
|
|
==================
|
|
This extension to the OpenStack Compute API enables listing of Virtual Interfaces of running instances.
|
|
|
|
New Actions
|
|
-----------
|
|
virtual_interfaces
|
|
|
|
New Faults
|
|
----------
|
|
None
|
|
|
|
New Headers
|
|
-----------
|
|
None
|
|
|
|
New Resources
|
|
-------------
|
|
None
|
|
|
|
New States
|
|
----------
|
|
None
|
|
|
|
Changes to the Cloud Servers Specification
|
|
------------------------------------------
|
|
A new action added to the 4.3 Server Actions section.
|
|
|
|
============= ==================
|
|
Verb URI
|
|
POST /servers/id/virtual_interfaces
|
|
============= ==================
|
|
|
|
Normal Response Code(s): 202
|
|
|
|
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)
|