# 查询DDM引擎信息V3
#### 功能介绍
查询DDM引擎信息详情V3接口。
#### 接口约束
无
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DDM&api=ListEngines)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
- URL格式
GET /v3/{project_id}/engines?offset={offset}\&limit={limit}
- 参数说明
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                         |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户在某一region下的project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ddm/ddm_api_01_0063.html)。 |
   
表2Query参数 
| 参数     | 是否必选 | 参数类型    | 描述                                                                                                                  |
|:---|:---|:---|:---|
| offset | 否    | Integer | 索引位置，偏移量。 从第一条数据偏移offset条数据后开始查询，默认为0。 取值必须为数字，且不能为负数。 |
| limit  | 否    | Integer | 查询个数上限值。 取值范围：1\~128。 不传该参数时，默认值为10。            |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                    |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务的"获取用户Token"接口来获取。 |
   
#### 请求示例
查询DDM引擎信息。
```
GET https://{endpoint}/v3/{project_id}/engines?offset=0&limit=10
```
#### 响应消息
- 正常响应参数说明
表4响应Body参数 
| 参数            | 参数类型                                                                            | 描述          |
|:---|:---|:---|
| engine_groups | Array of [EngineGroupInfo] objects | 引擎信息列表。     |
| offset        | Integer                                                                         | 分页参数: 起始值。  |
| limit         | Integer                                                                         | 分页参数：每页多少条。 |
| total         | Integer                                                                         | 引擎信息总数。     |
   
 表5EngineGroupInfo 
| 参数      | 参数类型   | 描述    |
|:---|:---|:---|
| id      | String | 引擎ID。 |
| name    | String | 引擎名称。 |
| version | String | 引擎版本。 |
   
- 正常响应示例
  ```
  {
    "engine_groups": [
      {
        "id": "036dc44a-b560-4316-9e7f-e25a60f2aea2",
        "name": "ddm",
        "version": "3.1.0.8"
      }
    ],
    "offset": 0,
    "limit": 1,
    "total": 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)。