Help Center/ Elastic Volume Service/ API Reference/ API Version Query/ Querying Information of an API Version
Updated on 2024-02-27 GMT+08:00

Querying Information of an API Version

Function

This API is used to query information of an API version.

URI

  • URI format

    GET /{api_version}

  • Parameter description

    Parameter

    Type

    Description

    api_version

    String

    The target API version.

    The value can be v1 or v2.

Request

  • Example request
    GET https://{endpoint}/v2

Response

  • Parameter description

    Parameter

    Type

    Description

    versions

    Array of objects

    The API version information. 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/v2"
                    }
                ], 
                "id": "v2.0", 
                "updated": "2014-06-28T12:20:21Z", 
                "version": "", 
                "status": "SUPPORTED"
            }
        ]
    }

Error Codes

See Error Codes.