2014-12-17 16:14:37 +00:00
|
|
|
..
|
2015-10-01 22:27:50 +00:00
|
|
|
Copyright 2009-2015 OpenStack Foundation
|
2014-12-17 16:14:37 +00:00
|
|
|
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
|
|
not use this file except in compliance with the License. You may obtain
|
|
|
|
a copy of the License at
|
|
|
|
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
|
|
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
|
|
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
|
|
License for the specific language governing permissions and limitations
|
|
|
|
under the License.
|
|
|
|
|
2015-09-22 10:59:47 +00:00
|
|
|
===========
|
|
|
|
Compute API
|
|
|
|
===========
|
|
|
|
|
2016-01-04 21:13:32 +00:00
|
|
|
The nova project has a RESTful HTTP service called the OpenStack Compute API.
|
2015-10-01 22:27:50 +00:00
|
|
|
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.
|
2015-09-22 10:59:47 +00:00
|
|
|
|
2015-11-25 12:47:01 +00:00
|
|
|
This guide covers the concepts in the OpenStack Compute API.
|
|
|
|
For a full reference listing, please see:
|
|
|
|
`Compute API Reference <http://developer.openstack.org/api-ref-compute-v2.1.html>`__.
|
|
|
|
|
2015-09-22 10:59:47 +00:00
|
|
|
We welcome feedback, comments, and bug reports at
|
|
|
|
`bugs.launchpad.net/nova <http://bugs.launchpad.net/nova>`__.
|
|
|
|
|
2015-10-01 22:27:50 +00:00
|
|
|
Intended audience
|
2015-09-22 10:59:47 +00:00
|
|
|
=================
|
|
|
|
|
|
|
|
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
|
2016-01-04 21:13:32 +00:00
|
|
|
* RESTful HTTP services
|
2015-09-22 10:59:47 +00:00
|
|
|
* HTTP/1.1
|
|
|
|
* JSON data serialization formats
|
2014-12-17 16:14:37 +00:00
|
|
|
|
2015-11-25 12:56:58 +00:00
|
|
|
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
|
2016-02-15 14:42:02 +00:00
|
|
|
be made available to most end users but this is fully configurable.
|
2015-11-25 12:56:58 +00:00
|
|
|
|
2015-11-25 12:47:01 +00:00
|
|
|
API Versions
|
|
|
|
============
|
2015-09-22 10:59:47 +00:00
|
|
|
|
2016-03-18 21:55:55 +00:00
|
|
|
Following the Mitaka release, every Nova deployment should have
|
2015-09-22 10:59:47 +00:00
|
|
|
the following endpoints:
|
|
|
|
|
|
|
|
* / - list of available versions
|
2015-12-08 02:03:51 +00:00
|
|
|
* /v2 - the first version of the Compute API, uses extensions
|
|
|
|
(we call this Compute API v2.0)
|
2015-09-22 10:59:47 +00:00
|
|
|
* /v2.1 - same API, except uses microversions
|
|
|
|
|
2015-11-25 12:47:01 +00:00
|
|
|
While this guide concentrates on documenting the v2.1 API,
|
2016-03-18 21:55:55 +00:00
|
|
|
please note that the v2.0 is (almost) identical to first microversion of
|
|
|
|
the v2.1 API and are also covered by this guide.
|
2015-11-25 12:47:01 +00:00
|
|
|
|
|
|
|
Contents
|
|
|
|
========
|
2014-12-17 16:14:37 +00:00
|
|
|
|
2015-04-28 10:34:31 +00:00
|
|
|
.. toctree::
|
2015-11-25 12:47:01 +00:00
|
|
|
:maxdepth: 2
|
2015-09-22 10:59:47 +00:00
|
|
|
|
2015-11-25 14:22:10 +00:00
|
|
|
users
|
2015-09-22 10:59:47 +00:00
|
|
|
versions
|
|
|
|
extensions
|
|
|
|
microversions
|
2015-10-01 22:27:50 +00:00
|
|
|
general_info
|
|
|
|
server_concepts
|
2015-04-28 10:34:31 +00:00
|
|
|
authentication
|
|
|
|
faults
|
|
|
|
limits
|
|
|
|
links_and_references
|
|
|
|
paginated_collections
|
|
|
|
polling_changes-since_parameter
|
|
|
|
request_and_response_formats
|
2016-03-13 20:08:49 +00:00
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
:hidden:
|
|
|
|
|
|
|
|
extra_specs_and_properties
|