Querying All API Versions

Function

This API is used to query all available Nova versions.

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 microversion 2.27, the new microversion header OpenStack-API-Version has been supported.

URI

GET /

Request

None

Response

The following table describes the response parameters.

**Table 1** Response parameters
Parameter	Type	Description
versions	Object	Specifies the API versions. For details, see Table 2.

**Table 2** **versions** field description
Parameter	Type	Description
id	string	Specifies the version ID.
links	Object	Specifies shortcut links for versions. For details, see Table 3.
min_version	string	Specifies the microversion. If the APIs of this version support microversions, set this parameter to the supported minimum microversion. If the microversion is not supported, leave this parameter blank.
status	string	Specifies the API version status. Possible values are as follows: CURRENT: This is the preferred API version. SUPPORTED: This is the old API version that is still supported. DEPRECATED: This is the deprecated API version that will be removed.
version	string	Specifies the microversion. If the APIs of this version support microversions, set this parameter to the supported maximum microversion. If the microversion is not supported, leave this parameter blank.
updated	string	The value of this parameter varies by API version. If the API version is 2.0, the value is 2011-01-21T11:33:21Z. If the API version is 2.1, the value is 2013-07-23T11:33:21Z.

**Table 3** **links** field description
Parameter	Type	Description
href	string	Specifies the links of the corresponding resources.
rel	string	self: A self link contains a versioned link to the resource. Use these links when the link is followed immediately. bookmark: A bookmark link provides a permanent link to a resource that is appropriate for long term storage. alternate: An alternate link can contain an alternate representation of the resource. For example, an OpenStack Compute image might have an alternate representation in the OpenStack Image service.

Example Request

Query all API versions.

GET https://{endpoint}/

Example Response

{
    "versions":[
        {
            "min_version":"",
            "links":[
                {
                    "rel":"self",
                    "href":"https://{endpoint}/v2/"
                }
            ],
            "id":"v2.0",
            "updated":"2011-01-21T11:33:21Z",
            "version":"",
            "status":"SUPPORTED"
        },
        {
            "min_version":"2.1",
            "links":[
                {
                    "rel":"self",
                    "href":"https://{endpoint}/v2.1/"
                }
            ],
            "id":"v2.1",
            "updated":"2013-07-23T11:33:21Z",
            "version":"2.60",
            "status":"CURRENT"
        }
    ]
}