文档中心

基础设施管理

模板管理

GetTemplate - 查询模板详情

查询私有或公共模板元数据及指定版本。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：GetTemplate

要执行的操作，取值：GetTemplate。

Version string 必选示例值：2026-05-01

API的版本，取值：2026-05-01。

TemplateID string 必选示例值：ptp-01arz3ndektsv4rrffq69g5fav

模板 ID。

TemplateVersion long 可选示例值：1

模板业务版本号；不传时返回最新版本。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

TemplateID string 示例值：ptp-01arz3ndektsv4rrffq69g5fav

模板 ID。

TemplateName string 示例值：演示

模板名称。

Description string 示例值：描述

模板描述。

Visibility string 示例值：Public

模板可见性，取值为 Private 或 Public。

Categories object[] 示例值：[{"Value":"AI","Name":"人工智能"}]

公共模板分类标签；私有模板不返回。

Value string 示例值：AI

分类标识。

Name string 示例值：人工智能

分类名称。

CreatedTime string 示例值：2026-09-10T08:00:00Z

创建时间。

UpdatedTime string 示例值：2026-09-10T08:00:00Z

更新时间。

Version object 示例值：{"TemplateVersion":1,"CreatedTime":"2026-09-10T08:00:00Z","TemplateURL":"https://download.example/template.zip?signed"}

选中的模板版本。

TemplateVersion long 示例值：1

模板业务版本号。

CreatedTime string 示例值：2026-09-10T08:00:00Z

创建时间。

TemplateURL string 示例值：https://download.example/template.zip?signed

模板版本 ZIP 的临时下载地址。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidParameter	The specified parameter %q is invalid.	请求参数不合法。
400	MissingParameter	The parameter %q is required.	缺少必填参数。
403	AccessDenied	Access to the requested template operation is denied.	无权访问指定模板或 Module。
403	NoPermittedOperation.TemplateNotPublished	The template is not published.	公共模板或 Module 未发布。
404	EntityNotFound.Template	The template %q does not exist.	模板不存在。
404	EntityNotFound.TemplateVersion	The template version does not exist.	模板或 Module 版本不存在。
500	InternalError	The request has failed due to an unknown error.	内部服务错误，请稍后重试。

最近更新时间：2026.10.19 21:23:17

这个页面对您有帮助吗？

有用

无用