
# 查询指定版本信息（OpenStack原生） - ShowVersion
#### 功能介绍
查询指定版本API的信息，包括该版本API的兼容性、域名信息等。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IMS/doc?locale=zh-cn&consoleCurrentProductId=ims&consoleCurrentProductshort=&api=ShowVersion)中调试该接口。
#### URI
GET /{version}
参数说明请参见[表1]。
 表1参数说明 
| 参数      | 是否必选 | 参数类型   | 描述             |
|:---|:---|:---|:---|
| version | 是    | String | API版本号。例如：v2.0 |
   
#### 请求消息
请求参数
无
#### 请求示例
查询指定版本API的信息。
```
GET https://{Endpoint}/v2.0
```
#### 响应消息
- 响应参数
  
  | 参数       | 参数类型             | 描述                                                                               |
  |:---|:---|:---|
  | versions | Array of objects | 版本信息。 详情请参见[表2]。 |
     
   表2versions字段说明 
  | 参数     | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                                                                              |
  |:---|:---|:---|
  | status | String           | 接口状态。 取值范围： - CURRENT: 这是使用的API的首选版本。  - SUPPORTED : 这是一个较老的，但仍然支持的API版本。  - DEPRECATED: 一个被废弃的API版本，该版本将被删除。   |
  | id     | String           | 接口ID。                                                                                                                                                                                                                                                                                                                                                                                           |
  | links  | Array of objects | 自描述信息。 详情请参见[表3]。                                                                                                                                                                                                                                                                                                                |
     
   表3versions.links字段说明 
  | 参数   | 参数类型   | 描述    |
  |:---|:---|:---|
  | href | String | 域名。   |
  | rel  | String | 域名描述。 |
     
  
- 响应样例
  ```
  STATUS CODE 300
  ```
  ```
  {
      "versions": [
          {
              "status": "SUPPORTED",
              "id": "v2.0",
              "links": [
                  {
                      "href": "https://image.az1.dc1.domainname.com/v2/",
                      "rel": "self"
                  }
              ]
          }
      ]
  }
  ```
  
 
#### 返回值
- 正常 300
  
- 异常
  
  | 返回值                       | 说明      |
  |:---|:---|
  | 400 Bad Request           | 请求错误。   |
  | 401 Unauthorized          | 鉴权失败。   |
  | 403 Forbidden             | 没有操作权限。 |
  | 404 Not Found             | 找不到资源。  |
  | 500 Internal Server Error | 服务内部错误。 |
  | 503 Service Unavailable   | 服务不可用。  |
     
  
 
