查询模板列表

功能介绍

根据提供的参数查询模板列表。

URI

GET /v2/templates

请求消息

N/A。

响应消息

• 响应参数

  失败响应消息如表5所示。

  表2 响应参数

  参数	参数类型	描述
  [数组元素]	Array of objects	数组元素为模板详细信息，详情请参见表3。

  表3 模板详细信息

  参数	参数类型	描述
  id	String	模板ID
  name	String	模板名称
  version	String	模板版本
  vendor	String	模板发布者
  description	String	模板描述
  project_id	String	模板所属项目ID
  template_url	String	模板包的存放地址
  origin_template_url	String	模板包的原始地址
  converge_url	String	模板的转化包地址，用于模板预览使用。
  create_at	String	模板创建时间
  update_at	String	模板更新时间
  scope	String	模板可用范围 project：项目内可用（现已不支持新建该范围的模板） domain：租户内可用 public：全局可用（跨租户可用）
  domain	String	模板所属租户名称
  main_file_name	String	主文件名，为空使用默认值，为blueprint.yaml。
  need_clutser	Boolean	判断模板是否需要CCE集群。当前AOS的应用都需要部署在CCE集群上。
  dsl_version	String	模板的DSL版本
  is_used	Boolean	检查模板是否在使用中（即存在使用此模板创建的堆栈），true表示在使用中。
  is_new_template	Boolean	模板是否是新模板
  include_stack	Boolean	模板里面是否包含堆栈（AOS.Stack）元素

  表4 响应消息头

  参数	参数类型	描述
  Content-Range	String	分页信息，items为起始和终止，以及总数”。具体取值依赖于用户的模板数量。 示例：items 0-24/66

• 响应示例

  [
      {
          "id": "f9f5839d-73e2-f22b-f20b-fb11bc1abb66",
          "name": "test-z",
          "version": "v1",
          "vendor": "aos-team",
          "description": "",
          "project_id": "",
          "template_url": "https://swr-api-server.manage.svc.cluster.local:20202/swr/v2/domains/aos-team/namespaces/aos-teame002/repositories/stack_templates/packages/test-z/versions/v1/file_paths/test-staless-container.tar.gz",
          "converge_url": "https://swr-api-server.manage.svc.cluster.local:20202/swr/v2/domains/aos-team/namespaces/aos-teame002/repositories/stack_templates/packages/test-z/versions/v1/file_paths/test-z-v1-converge.tar.gz",
          "origin_template_url": "",
          "create_at": "2018-12-16T01:15:39Z",
          "update_at": "2018-12-16T01:15:41Z",
          "scope": "domain",
          "domain": "aos-team",
          "main_file_name": "blueprint.yaml",
          "need_cluster": true,
          "dsl_version": "cloud_tosca_version_",
          "is_used": true,
          "is_new_template": false,
          "include_stack": false
      },
      {
          "id": "fd3f1e6d-cc93-c3c3-d015-f69c3ff3bc63",
          "name": "test-z",
          "version": "v2",
          "vendor": "aos-team",
          "description": "",
          "project_id": "",
          "template_url": "https://swr-api-server.manage.svc.cluster.local:20202/swr/v2/domains/aos-team/namespaces/aos-teame002/repositories/stack_templates/packages/test-z/versions/v2/file_paths/blueprint.zip",
          "converge_url": "https://swr-api-server.manage.svc.cluster.local:20202/swr/v2/domains/aos-team/namespaces/aos-teame002/repositories/stack_templates/packages/test-z/versions/v2/file_paths/test-z-v2-converge.tar.gz",
          "origin_template_url": "",
          "create_at": "2018-12-16T04:09:24Z",
          "update_at": "2018-12-16T04:09:26Z",
          "scope": "domain",
          "domain": "aos-team",
          "main_file_name": "blueprint.yaml",
          "need_cluster": true,
          "dsl_version": "cloud_tosca_version_",
          "is_used": true,
          "is_new_template": false,
          "include_stack": false
      }
  ]

状态码

• 正常

  表5 状态码

  状态码	描述
  200	查询模板列表成功。

• 异常

  表6 状态码

  状态码	描述
  500	服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。