
# 查询指定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"
    }
}
```
#### 返回值
正常返回值：
| 返回值 | 说明           |
|:---|:---|
| 200 | 服务器已成功处理了请求。 |
   
其他返回值请参考[状态码](https://support.huaweicloud.com/api-bms/bms_api_0801.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-bms/bms_api_0802.html)。
