# 查询模板列表 - ListTemplates
#### 功能介绍
根据用户请求条件从数据库筛选、查询启动模板相关信息。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ECS/doc?api=ListTemplates)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ecs/ecs_06_0000.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
 
| 授权项                      | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 |
|:---|:---|:---|:---|:---|:---|
| ecs:launchTemplates:list | list | -           | -   | -  | -      |
   
#### URI
GET /v3/{project_id}/launch-templates
参数说明请参见[表1]。
 表1路径参数 
| 参数         | 是否必选 | 描述                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|
| project_id | 是    | **参数解释** **：** 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ecs/ecs_01_0016.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
   
表2查询参数 
| 参数                 | 是否必选 | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| limit              | 否    | Integer          | **参数解释** **：** 查询返回的模板最大资源数。 **约束限制：** 最多返回100个模板的信息。 **取值范围：** 不涉及 **默认取值：** 不涉及               |
| marker             | 否    | String           | **参数解释** **：** 从marker指定的模板ID的下一条数据开始查询。 **约束限制：** marker需要与limit配合使用。 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| launch_template_id | 否    | Array of strings | **参数解释** **：** 模板ID。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                    |
| name               | 否    | Array of strings | **参数解释** **：** 模板名称。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                    |
   
#### 请求消息
无。
#### 响应消息
响应参数如[表3]所示。
 表3响应参数 
| 参数               | 参数类型             | 描述                                                                                                                                                                                        |
|:---|:---|:---|
| launch_templates | Arrays Of Object | **参数解释** **：** 模板信息。详情请参见[表4]。 **取值范围：** 不涉及 |
| page_info        | Object           | **参数解释** **：** 翻页信息。详情请参见[表5]。 **取值范围：** 不涉及                  |
   
 表4launch_template参数信息 
| 参数              | 参数类型    | 描述                                                                                                                                                |
|:---|:---|:---|
| id              | String  | **参数解释** **：** 模板id。 **取值范围：** 不涉及     |
| name            | String  | **参数解释** **：** 模板名称。 **取值范围：** 不涉及      |
| description     | String  | **参数解释** **：** 模板描述 **取值范围：** 不涉及                       |
| created_at      | String  | **参数解释** **：** 模板创建时间。 **取值范围：** 不涉及   |
| updated_at      | String  | **参数解释** **：** 模板更新时间。 **取值范围：** 不涉及 |
| default_version | Integer | **参数解释** **：** 模板默认版本号。 **取值范围：** 不涉及                  |
| latest_version  | Integer | **参数解释** **：** 模板最新版本号。 **取值范围：** 不涉及                   |
   
 表5page_info参数信息 
| 参数              | 参数类型   | 描述                                                                                                                                 |
|:---|:---|:---|
| next_marker     | String | **参数解释** **：** 下一页的开始索引ID。 **取值范围：** 不涉及 |
| previous_marker | String | **参数解释** **：** 上一页的开始索引ID。 **取值范围：** 不涉及  |
   
#### 请求示例
查询模板列表。
```
GET https://{endpoint}/v3/{project_id}/launch-templates
```
#### 响应示例
```
{
    "launch_templates": [
        {
            "id": "e6b99563-xxxx-xxxx-xxxx-1820d4fd2a67",
            "name": "my-template",
            "description": "this template is used for XXXXXX",
            "created_at": "XXXX-XX-XXTXX:XX:XX.XXXZ",
            "updated_at": "XXXX-XX-XXTXX:XX:XX.XXXZ",
            "default_version": 2,
            "latest_version": 3
        }
    ],
    "page_info": {
        "next_marker": "string"
    }
}
```
#### 返回值
请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-ecs/ecs_07_0002.html)。