文档首页/ 弹性云服务器 ECS/ API参考/ API/ 模板管理/ 查询模板列表
更新时间：2025-09-16 GMT+08:00
查看PDF
分享

查询模板列表

功能介绍

根据用户请求条件从数据库筛选、查询启动模板相关信息。

URI

GET /v3/{project_id}/launch-templates

参数说明请参见表1。
表1 路径参数

参数

是否必选

描述

project_id

是

项目ID。

获取方法请参见获取项目ID。
表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。
表4 launch_template参数信息

参数

参数类型

描述

id

String

模板id。

name

String

模板名称。

description

String

模板描述

created_at

String

模板创建时间。

updated_at

String

模板更新时间。

default_version

Integer

模板默认版本号。

latest_version

Integer

模板最新版本号。
表5 page_info参数信息

参数

参数类型

描述

next_marker

String

下一页的开始索引ID。

previous_marker

String

上一页的开始索引ID。

请求示例

查询模板列表。

GET https://{endpoint}/v3/{projectId}/launch-templates

响应示例

{   
    "launch_templates": [     
       {       
         "id": "e6b99563-xxxx-xxxx-xxxx-1820d4fd2a67",   
         "name": "my-template",     
         "description": "this template is used for XXXXXX", 
         "created_at": "XXXXX-XX-XX",     
         "updated_at": "XXXXX-XX-XX",     
         "default_version": 2,      
         "latest_version": 3   
        }
      ], 
     "page_info": { 
        "next_marker": "string" 
      }
 }

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 模板管理