
# 查询API版本信息列表 - ShowVersionsInfo
#### 功能介绍
查询裸金属服务器当前所有可用的API版本。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/doc?api=ShowVersionsInfo)中调试该接口。
#### URI
GET /
#### 请求参数
无
#### 请求示例
查询当前所有可用的API版本。
```
GET https://{BMS Endpoint}/
```
#### 响应参数
| 参数       | 参数类型             | 描述                                                              |
|:---|:---|:---|
| versions | Array of objects | 描述裸金属服务器API版本信息列表。详情请参见[表1]。 |
   
 表1versions字段数据结构说明 
| 参数          | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|
| id          | String           | API版本ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| links       | Array of objects | API的url地址。详情请参见[表2]。                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| min_version | String           | API支持的最小微版本号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| status      | String           | API版本状态： - CURRENT：表示该版本为主推版本。  - SUPPORTED：表示为老版本，但是现在还在继续支持。  - DEPRECATED：表示为废弃版本，存在后续删除的可能。   |
| updated     | String           | API版本发布时间。 时间戳格式为ISO 8601：YYYY-MM-DDTHH:MM:SSZ，例如：2018-09-30T00:00:00Z                                                                                                                                                                                                                                                                                                                                                                                                             |
| version     | String           | API支持的最大微版本号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   
 表2links字段数据结构说明 
| 参数   | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|
| href | String | API的url地址。                                                                                                                                                                                                                                                                                                                            |
| rel  | String | API的url地址依赖。取值为： - self：包含版本号的资源链接，需要立即跟踪时使用此类链接。  - bookmark：提供了适合长期存储的资源链接。   |
   
#### 响应示例
```
{
    "versions": [
        {
            "id": "v1",
            "links": [
                {
                    "href": "http://bms.example.com/v1/",
                    "rel": "self"
                }
            ],
            "min_version": "",
            "status": "CURRENT",
            "updated": "2018-09-30T00:00:00Z",
            "version": ""
        }
    ]
}
```
#### 返回值
正常返回值：
| 返回值 | 说明           |
|:---|:---|
| 200 | 服务器已成功处理了请求。 |
   
其他返回值请参考[状态码](https://support.huaweicloud.com/api-bms/bms_api_0801.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-bms/bms_api_0802.html)。
