# 查询DDM可变更内核版本V3
#### 功能介绍
获取DDM实例可变更的内核版本。
#### 接口约束
无
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DDM&api=ListEngines)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
- URL格式 GET /v3/{project_id}/instances/{instance_id}/database-version/available-versions
  
- 参数说明
  表1路径参数 
  | 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                        |
  |:---|:---|:---|:---|
  | project_id  | 是    | String | 租户在某一region下的project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ddm/ddm_api_01_0063.html)。 |
  | instance_id | 是    | String | DDM实例ID。                                                                                                                                                  |
     
  
 
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                    |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务的"获取用户Token"接口来获取。 |
   
#### 请求示例
获取DDM实例可变更的内核版本。
```
GET https://{endpoint}/v3/{project_id}/instances/{instance_id}/database-version/available-versions
```
#### 响应消息
- 正常响应参数说明
  表3响应Body参数 
  | 参数                      | 参数类型             | 描述                                      |
  |:---|:---|:---|
  | versions                | Array of strings | 可变更的内核版本。                               |
  | current_version         | String           | DDM实例当前内核版本。                            |
  | latest_version          | String           | 最新优选版本，属于可变更的内核版本。                      |
  | current_favored_version | String           | 系列优选版本，如3.0.8系列优选版本为3.0.8.5，属于可变更的内核版本。 |
  | previous_version        | String           | DDM实例最近一次升级前版本。                         |
     
  
- 正常响应示例
  ```
  {
    "versions": [
      "3.1.0.7"
    ],
    "current_version": "3.0.8.5",
    "latest_version": "3.1.0.7",
    "current_favored_version": "3.0.8.5",
    "previous_version": "3.0.8.3"
  }
  ```
  
- 异常响应 请参见[异常请求结果](https://support.huaweicloud.com/api-ddm/ddm_api_01_0059.html)。
  
 
#### 状态码
- 正常 200
  
- 异常 请参见[状态码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0060.html)。
  
 
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0061.html)。