查询指定API版本信息

功能介绍

返回指定API版本的信息。

URI

GET /{api_version}

参数说明请参见表1。

表1 参数说明
参数	是否必选	描述
api_version	是	API版本号。例如：v2

请求参数

无

请求示例

查询v2版本的API版本信息。

 GET https://{ECS Endpoint}/v2
 

响应参数

参数	参数类型	描述
version	Object	描述version对象。
id	String	版本ID（版本号），如v1。
links	Array of objects	API的URL地址。
href	String	当前API版本的引用地址。
rel	String	当前API版本和被引用地址的关系。
version	String	若该版本API支持微版本，则为支持的最大微版本号；如果不支持微版本，则为空。
status	String	版本状态，为如下3种： CURRENT：表示该版本为主推版本。 SUPPORTED：表示为老版本，但是现在还继续支持。 DEPRECATED：表示为废弃版本，存在后续删除的可能。
updated	String	版本发布时间，要求用UTC时间表示。例如v1发布的时间为：2014-06-28T12:20:21Z。
min_version	String	若该版本API支持微版本，则为支持的最小微版本号；如果不支持微版本，则为空。

响应示例

 {
    "version": {
        "min_version": "",
        "media-types": [
            {
                "type": "application/vnd.openstack.compute+json;version=2",
                "base": "application/json"
            }
        ],
        "links": [
            {
                "rel": "self",
                "href": "https://ecs.service.domain.com:443/v2/"
            },
            {
                "rel": "describedby",
                "href": "http://docs.openstack.org/",
                "type": "text/html"
            }
        ],
        "id": "v2.0",
        "updated": "1999-02-20T11:33:21Z",
        "version": "",
        "status": "SUPPORTED"
    }
}
 