使用DescribeTemplateAttribute查询编排模板详情-容器服务 Kubernetes 版 ACK-阿里云

编排模板是对一组Kubernetes集群资源的定义和描述，以声明性方式描述应用应该如何运行或者配置。您可以调用DescribeTemplateAttribute接口，查询目标编排模板的详细信息，包括访问权限、YAML内容、标签等。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
cs:DescribeTemplateAttribute	get	全部资源 ``	无	无

请求语法

GET /templates/{TemplateId} HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
TemplateId	string	是	模板 ID。	874ec485-e7e6-4373-8a3b-47bde8a****
template_type	string	否	模板类型。当取值为`kubernetes`时将在控制台的编排模板页面展示该模板。该参数不填写或者取值为其他值时，控制台的编排模板页面将不会展示该模板。推荐设置为`kubernetes`。	kubernetes

返回参数

名称	类型	描述	示例值
	array<object>	编排模板详情。
template_info	object	请求数据体。
id	string	编排模板 ID，每次变更都会有一个模板 ID。	72d20cf8-a533-4ea9-a10d-e7630d3d****
acl	string	编排模板的访问权限，取值： `private`：私有。 `public`：公共。 `shared`：可共享。	private
name	string	编排模板名称。	web
template	string	编排模板 YAML 内容。	apiVersion: V1\n***
template_type	string	模板类型。当取值为 kubernetes 时将在控制台的编排模板页面展示该模板。该参数不填写或者取值为其他值时，控制台的编排模板页面将不会展示该模板。	kubernetes
description	string	编排模板描述信息。	test template
tags	string	部署模板的标签。	sa
template_with_hist_id	string	编排模板唯一 ID，不随模板更新而改变。	874ec485-e7e6-4373-8a3b-47bde8ae****
created	string	编排模板创建时间。	2025-04-25T16:56:33+08:00
updated	string	编排模板更新时间。	2025-04-25T16:56:33+08:00

示例

正常返回示例

JSON格式

[
  {
    "id": "72d20cf8-a533-4ea9-a10d-e7630d3d****",
    "acl": "private",
    "name": "web",
    "template": "apiVersion: V1\\n***",
    "template_type": "kubernetes",
    "description": "test template",
    "tags": "sa",
    "template_with_hist_id": "874ec485-e7e6-4373-8a3b-47bde8ae****",
    "created": "2025-04-25T16:56:33+08:00",
    "updated": "2025-04-25T16:56:33+08:00"
  }
]

错误码

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

变更历史

变更时间	变更内容概要	操作

暂无变更历史