Querying Information of API Versions

Function

This API is used to query information of API versions.

URI

URI format
GET /

Request

Example request
```
GET https://{endpoint}/
```

Response

Parameter description

Parameter	Type	Description
versions	Array of objects	The API versions. For details, see Parameters in the versions field.

Parameters in the versions field

Parameter	Type	Description
min_version	String	The minimum microversion supported. If this version does not support microversions, the value is an empty string.
media-types	Array of objects	The request message type of the API version. For details, see Parameters in the media-types field.
links	Array of objects	The URI of the API version. For details, see Parameters in the links field.
id	String	The ID of the API version.
updated	String	The last time when the API version was updated. Time format: UTC YYYY-MM-DDTHH:MM:SS.XXXXXX
version	String	The maximum microversion supported. If this version does not support microversions, the value is an empty string.
status	String	The API version status. The value can be as follows: CURRENT: EVS custom APIs provide multiple versions. For APIs offering the same functions, you are recommended to use the v2 APIs. SUPPORTED: indicates an earlier version which is still supported. DEPRECATED: indicates a deprecated version that may be deleted later.

Parameters in the media-types field

Parameter	Type	Description
type	String	The response type.
base	String	The text type.

Parameters in the links field

Parameter	Type	Description
rel	String	The domain name description.
href	String	The domain name.
type	String	The response type.

Example response

{
    "versions": [
        {
            "min_version": "", 
            "media-types": [
                {
                    "type": "application/vnd.openstack.volume+json;version=1", 
                    "base": "application/json"
                }, 
                {
                    "type": "application/vnd.openstack.volume+xml;version=1", 
                    "base": "application/xml"
                }
            ], 
            "links": [
                {
                    "rel": "describedby", 
                    "href": "http://docs.openstack.org/", 
                    "type": "text/html"
                }, 
                {
                    "rel": "self", 
                    "href": "https://evs.localdomain.com/v1"
                }
            ], 
            "id": "v1.0", 
            "updated": "2014-06-28T12:20:21Z", 
            "version": "", 
            "status": "SUPPORTED"
        }, 
        {
            "min_version": "", 
            "media-types": [
                {
                    "type": "application/vnd.openstack.volume+json;version=1", 
                    "base": "application/json"
                }, 
                {
                    "type": "application/vnd.openstack.volume+xml;version=1", 
                    "base": "application/xml"
                }
            ], 
            "links": [
                {
                    "rel": "describedby", 
                    "href": "http://docs.openstack.org/", 
                    "type": "text/html"
                }, 
                {
                    "rel": "self", 
                    "href": "https://evs.localdomain.com/v2"
                }
            ], 
            "id": "v2.0", 
            "updated": "2014-06-28T12:20:21Z", 
            "version": "", 
            "status": "SUPPORTED"
        }, 
        {
            "min_version": "3.0", 
            "media-types": [
                {
                    "type": "application/vnd.openstack.volume+json;version=1", 
                    "base": "application/json"
                }, 
                {
                    "type": "application/vnd.openstack.volume+xml;version=1", 
                    "base": "application/xml"
                }
            ], 
            "links": [
                {
                    "rel": "describedby", 
                    "href": "http://docs.openstack.org/", 
                    "type": "text/html"
                }, 
                {
                    "rel": "self", 
                    "href": "https://evs.localdomain.com/v3"
                }
            ], 
            "id": "v3.0", 
            "updated": "2016-02-08T12:20:21Z", 
            "version": "3.0", 
            "status": "CURRENT"
        }
    ]
}