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.
Parameter | Type | Description |
---|---|---|
id | string | Specifies the version ID. |
links | Object | Specifies shortcut links for versions. For details, see Table 3. |
min_version | string |
|
status | string | Specifies the API version status. Possible values are as follows:
|
version | string |
|
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. |
Parameter | Type | Description |
---|---|---|
href | string | Specifies the links of the corresponding resources. |
rel | string |
|
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"
}
]
}