Files
nova/doc/source/api_ext/ext_virtual_interfaces.rst
Doug Hellmann c16cd04cf6 Fix rst formatting and cross-references
blueprint sphinx-doc-cleanup
bug 944385

- Fix formatting and markup issues that produce error messages
- Update TOC lists for missing/new files
- Fix a few links
- Update instructions with dependencies for building the documentation
- Updated base on review comments from oubiwann to fix trailing whitespace in modified files

Change-Id: I589152bfab9c543d2b11fa8bed2344259aa90675
2012-03-06 08:08:25 -05:00

2.7 KiB

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://mycloud.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)