查询模板列表
功能介绍
根据用户请求条件从数据库筛选、查询启动模板相关信息。
调试
您可以在API Explorer中调试该接口。
URI
GET /v3/{project_id}/launch-templates
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
limit |
否 |
Integer |
查询返回的模板最大资源数。最多返回100个模板的信息。 |
marker |
否 |
String |
从marker指定的模板ID的下一条数据开始查询。 marker需要与limit配合使用。 |
launch_template_id |
否 |
Array of strings |
模板ID。 |
name |
否 |
Array of strings |
模板名称。 |
请求消息
无。
响应消息
响应参数如表3所示。
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
模板id。 |
name |
String |
模板名称。 |
description |
String |
模板描述 |
created_at |
String |
模板创建时间。 |
updated_at |
String |
模板更新时间。 |
default_version |
Integer |
模板默认版本号。 |
latest_version |
Integer |
模板最新版本号。 |
请求示例
查询模板列表。
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" } }
返回值
请参考通用请求返回值。
错误码
请参考错误码。