查询所有编排模板 - 容器服务 ACK

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求语法

GET /templates?template_type=String&page_num=Long&page_size=Long HTTP/1.1 
Content-Type:application/json

请求参数

表 1. 请求Query参数
参数名称	类型	是否必选	示例	说明
template_type	String	是	kubernetes	模板类型，值可以是任意值。当取值是`kubernetes`时将在控制台的编排模板页面展示该模板。当取值是`compose`时将不在控制台的编排模板页面展示该模板。默认值：`kubernetes`。
page_num	Long	否	1	对查询结果进行分页处理，指定返回第几页的数据。默认值： 1。
page_size	Long	否	10	对查询结果进行分页处理，指定每页包含的数据条数。默认值：10。

响应体语法

HTTP/1.1 200
Content-Type:application/json
{
  "templates" : [ {
    "acl" : "String",
    "id" : "String",
    "name" : "String",
    "description" : "String",
    "tags" : "String",
    "template" : "String",
    "template_type" : "String",
    "created" : "String",
    "updated" : "String",
    "template_with_hist_id" : "String"
  } ],
  "page_info" : {
    "page_number" : Long,
    "page_size" : Long,
    "total_count" : Long
  }
}

响应参数

表 2. 响应Body参数
参数名称	类型	示例	说明
templates	Array of template		模板列表。
acl	String	private	用户部署模板的访问权限，取值： `private`：私有的。 `public`：公共的。 `shared`：可共享的。默认值：`private`。
id	String	874ec485-e7e6-4373-8a3b-47bde8ae789f	部署模板ID。
name	String	webserver	部署模板名称。
description	String	a web server	部署模板描述信息。
tags	String	kubernetes	部署模板的标签，如果不显式指定，默认为模板名称。
template	String	apiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: nginx-deployment-basic\n labels:\n app: nginx\nspec:\n replicas: 2\n selector:\n matchLabels:\n app: nginx\n template:\n metadata:\n labels:\n app: nginx\n spec:\n containers:\n - name: nginx\n image: busybox:latest\n ports:\n - containerPort: 80	YAML格式的模板内容。
template_type	String	kubernetes	模板类型，值可以是任意值。当取值是`kubernetes`时将在控制台的编排模板页面展示该模板。当取值是`compose`时将在控制台Swarm集群页面显示该模板（已废弃）。
created	String	2020-06-10T16:30:16+08:00	部署模板创建时间。
updated	String	2020-06-10T16:30:16+08:00	部署模板更新时间。
template_with_hist_id	String	ad81d115-7c8b-47e7-a222-9c28d7f6e588	模板关联的父模板ID，用于实现模板多版本功能（同一模板的不同版本拥有相同的`template_with_hist_id`值）。
page_info	object		分页信息。
page_number	Long	20	展示当前页数。
page_size	Long	3	单页最大数据条数。
total_count	Long	50	结果总数。

查询所有编排模板示例

请求示例

GET /templates?template_type=kubernetes&page_num=1&page_size=10 HTTP/1.1 
Content-Type:application/json

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<templates>
    <acl>private</acl>
    <id>874ec485-e7e6-4373-8a3b-47bde8ae789f</id>
    <name>webserver</name>
    <description>a web server</description>
    <tags>kubernetes</tags>
    <template>apiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: nginx-deployment-basic\n  labels:\n    app: nginx\nspec:\n  replicas: 2\n  selector:\n    matchLabels:\n      app: nginx\n  template:\n    metadata:\n      labels:\n        app: nginx\n    spec:\n      containers:\n      - name: nginx\n        image: busybox:latest\n        ports:\n        - containerPort: 80</template>
    <template_type>kubernetes</template_type>
    <created>2020-06-10T16:30:16+08:00</created>
    <updated>2020-06-10T16:30:16+08:00</updated>
    <template_with_hist_id>ad81d115-7c8b-47e7-a222-9c28d7f6e588</template_with_hist_id>
</templates>
<page_info>
    <page_number>20</page_number>
    <page_size>3</page_size>
    <total_count>50</total_count>
</page_info>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "templates" : [ {
    "acl" : "private",
    "id" : "874ec485-e7e6-4373-8a3b-47bde8ae789f",
    "name" : "webserver",
    "description" : "a web server",
    "tags" : "kubernetes",
    "template" : "apiVersion: apps/v1\\nkind: Deployment\\nmetadata:\\n  name: nginx-deployment-basic\\n  labels:\\n    app: nginx\\nspec:\\n  replicas: 2\\n  selector:\\n    matchLabels:\\n      app: nginx\\n  template:\\n    metadata:\\n      labels:\\n        app: nginx\\n    spec:\\n      containers:\\n      - name: nginx\\n        image: busybox:latest\\n        ports:\\n        - containerPort: 80",
    "template_type" : "kubernetes",
    "created" : "2020-06-10T16:30:16+08:00",
    "updated" : "2020-06-10T16:30:16+08:00",
    "template_with_hist_id" : "ad81d115-7c8b-47e7-a222-9c28d7f6e588"
  } ],
  "page_info" : {
    "page_number" : 20,
    "page_size" : 3,
    "total_count" : 50
  }
}

错误码

访问错误中心查看更多错误码。

开发者资源

SDK
阿里云为您提供多种语言的SDK，帮助您快速通过API集成阿里云的产品和服务，推荐您使用SDK调用API，已免除您手动签名验证，详情请参见SDK参考文档链接。
OpenAPI Explorer
快速检索，可视化调试API，在线命令行工具，同步动态生成可执行的SDK代码示例。
阿里云CLI
阿里云资产管理和配置工具，可通过命令方式同时管理多个阿里云产品和服务，简单快捷，是您上云好帮手。