Files
f25648a963800537d39c3019811ecc5485f8b33e
nova /api-guide /source /index.rst
Andreas Jaeger f25648a963 Error on API Guide warnings 
Error on warnings in building the API guide and fix any problem
encountered:
* tox.ini: Enable tread warnings as errors
* index.rst: Add unreferenced file extra_specs_and_properties as
 hidden file so that it does not show up in index. It is still
 built and will be referenced from other files.
* general_info.rst: Remove reference to non-existing file
* server_concept: Add missing empty line after code directives
Also fix a typo and remove extra EOL whitespace.
Change-Id: Ie766f8d2f7d82b7b5b02541b342f9829ca4550a0
2016年03月17日 07:57:23 +01:00

2.9 KiB

Compute API

The nova project has a RESTful HTTP service called the OpenStack Compute API. Through this API, the service provides massively scalable, on demand, self-service access to compute resources. Depending on the deployment those compute resources might be Virtual Machines, Physical Machines or Containers.

This guide covers the concepts in the OpenStack Compute API. For a full reference listing, please see: Compute API Reference.

We welcome feedback, comments, and bug reports at bugs.launchpad.net/nova.

Intended audience

This guide assists software developers who want to develop applications using the OpenStack Compute API. To use this information, you should have access to an account from an OpenStack Compute provider, or have access to your own deployment, and you should also be familiar with the following concepts:

  • OpenStack Compute service
  • RESTful HTTP services
  • HTTP/1.1
  • JSON data serialization formats

End User and Operator APIs

The Compute API includes all end user and operator API calls. The API works with keystone and oslo.policy to deliver RBAC (Role-based access control). The default policy file gives suggestions on what APIs should not be made available to most end users but this is fully configurable.

API Versions

Following the Liberty release, every Nova deployment should have the following endpoints:

  • / - list of available versions
  • /v2 - the first version of the Compute API, uses extensions

    (we call this Compute API v2.0)

  • /v1.1 - an alias for v2.0 for backwards compatibility
  • /v2.1 - same API, except uses microversions

While this guide concentrates on documenting the v2.1 API, please note that the v2.0 and v1.1 API are (almost) identical to first microversion of the v2.1 API and are also covered by this guide.

Contents

users versions extensions microversions general_info server_concepts authentication faults limits links_and_references paginated_collections polling_changes-since_parameter request_and_response_formats

extra_specs_and_properties