• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  3. API Reference
  4. Nova
  5. API Version Query
  6. Querying a Specified API Version

Querying a Specified API Version

Function Description

This interface is used to query the information of a specified version.

To support function extension, Nova APIs can be distinguished by version. There are two types of versions:

  • Major version: Independent URL
  • Microversion: Used by the HTTP request header X-OpenStack-Nova-API-Version. Since version 2.27, the new microversion header OpenStack-API-Version has been supported.

URI

GET /{api_version}

Table 1 describes the parameters in the URI.
Table 1 Parameter description

Parameter

Mandatory

Description

api_version

Yes

Specifies an API version, such as V2.

Examples

  • Example request
    GET /v2
  • Example response
    {
     "version": {
      "min_version": "",
      "media-types": [{
       "type": "application/vnd.openstack.compute+json;version=2",
       "base": "application/json"
      }],
      "links": [{
       "rel": "self",
       "href": "https://ecs.service.domain.com:443/v2/"
      },
      {
       "rel": "describedby",
       "href": "http://docs.openstack.org/",
       "type": "text/html"
      }],
      "id": "v2.0",
      "updated": "1999-02-20T11:33:21Z",
      "version": "",
      "status": "SUPPORTED"
     }
    }

Returned Values

See General Request Returned Values.