Querying a Specified API Version¶

Function Description¶

This API 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.
Note
If the OpenStack-API-Version request header is used, the version is in the format of "compute microversion".
For example, if key is set to OpenStack-API-Version, set value to compute 2.27.

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.

Request¶

None

Response¶

The following table describes the response parameters.

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

**Table 3** **versions** field description¶
Parameter	Type	Description
id	string	Specifies the version ID.
links	Object	Specifies the links to resources. For more information, see the OpenStack Documentation. For details, see Table 4.
media-types	Object	Specifies the media types. For details, see Table 5.
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.
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.
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.

**Table 4** **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.

**Table 5** **media-types** field description¶
Parameter	Type	Description
base	string	Specifies the basic type.
type	string	Specifies the media type.

Example Request¶

Query information about a specified API version.

GET https://{endpoint}/v2.1

Example Response¶

{
    "version":{
        "min_version":"2.1",
        "media-types":[
            {
                "type":"application/vnd.openstack.compute+json;version=2.1",
                "base":"application/json"
            }
        ],
        "links":[
            {
                "rel":"self",
                "href":"https://{endpoint}/v2.1/"
            },
            {
                "rel":"describedby",
                "href":"http://docs.openstack.org/",
                "type":"text/html"
            }
        ],
        "id":"v2.1",
        "updated":"2013-07-23T11:33:21Z",
        "version":"2.60",
        "status":"CURRENT"
    }
}

Returned Values¶

See Returned Values for General Requests.

last updated: 2024-12-17 08:54 UTC - commit: 60d73b5e88a7b9e2d4d3346634d7fac6006f7365