列举模板版本

功能介绍

列举模板版本信息（ListTemplateVersions）

此API用于列举模板下所有的模板版本信息

• 默认按照生成时间降序排序，最新生成的模板排列在最前面

• 注意：目前返回全量模板版本信息，即不支持分页

• 如果没有任何模板版本，则返回空list

• template_id是模板的唯一Id。此Id由资源编排服务在生成模板的时候生成，为UUID。由于模板名仅仅在同一时间下唯一，即用户允许先生成一个叫HelloWorld的模板，删除，再重新创建一个同名模板。对于团队并行开发，用户可能希望确保，当前我操作的模板就是我认为的那个，而不是其他队友删除后创建的同名模板。因此，使用ID就可以做到强匹配。资源编排服务保证每次创建的模板所对应的ID都不相同，更新不会影响ID。如果给予的template_id和当前模板管理的ID不一致，则返回400

• 如果模板不存在则返回404

ListTemplateVersions返回的信息只包含模板版本摘要信息（具体摘要信息见ListTemplateVersionsResponseBody），如果用户需要了解模板版本内容，请调用ShowTemplateVersionContent

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v1/{project_id}/templates/{template_name}/versions

请求参数

响应参数

状态码： 200

状态码： 400

状态码： 401

状态码： 403

状态码： 404

状态码： 429

状态码： 500

请求示例

• 列举当前模板的所有的模板版本信息

  GET https://{endpoint}/v1/c364070ab35041ddae68cf8b4839b60f/templates/my_template/versions

• 列举当前模板的所有的模板版本信息，并提供模板id以校验是否与当前模板匹配

  GET https://{endpoint}/v1/c364070ab35041ddae68cf8b4839b60f/templates/my_template/versions?template_id=1b15e005-bdbb-4bd7-8f9a-a09b6774b4b3

响应示例

状态码： 200

列举模板版本成功

{
  "versions" : [ {
    "template_id" : "69f8d5ea-eaa4-4a3b-a96d-bae9230e97c8",
    "template_name" : "my_first_template",
    "version_description" : "当前模板的第二个版本",
    "create_time" : "2023-05-09T08:01:24Z",
    "version_id" : "V2"
  }, {
    "template_id" : "69f8d5ea-eaa4-4a3b-a96d-bae9230e97c8",
    "template_name" : "my_first_template",
    "version_description" : "当前模板的第一个版本",
    "create_time" : "2023-05-09T08:01:23Z",
    "version_id" : "V1"
  } ]
}

状态码