文档中心

基础设施管理

资源栈管理

ValidateTemplate - 校验模板

校验模板并返回变量定义和值

调试

API Explorer

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

去调试

请求参数

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

Action string 必选示例值：ValidateTemplate

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

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

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

TemplateURL string 可选示例值：https://xxx/template.zip

模板 URL，支持 HTTP、HTTPS 或 tos:// 来源，模板最大为 5 MB。TemplateURL、TemplateID、ModuleID 必须且只能选择一种来源。

TemplatePath string 可选示例值：/

模板包内相对目录，最长 1024 字符。默认根目录。需与模板来源一起传入。

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

在线模板 ID。TemplateURL、TemplateID、ModuleID 必须且只能选择一种来源。传入时必须同时指定 TemplateVersion。

TemplateVersion long 可选示例值：1

模板业务版本号，必须大于 0。传入 TemplateID 时必填。

ModuleID string 可选示例值：mod-01arz3ndektsv4rrffq69g5fav

公共 Module ID。TemplateURL、TemplateID、ModuleID 必须且只能选择一种来源。传入时必须同时指定 ModuleVersion 和非根目录 TemplatePath。

ModuleVersion long 可选示例值：1

Module 业务版本号，必须大于 0。传入 ModuleID 时必填。

返回参数

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

Variables object[] 示例值：-

模板变量定义列表

Key string 示例值：vpc_name

变量名

Description string 示例值：VPC Name

变量描述

Type string 示例值：string

变量类型

Required boolean 示例值：false

是否必填

Sensitive boolean 示例值：false

是否敏感变量

HasDefault boolean 示例值：true

是否有默认值

Default object 示例值：vpc-demo123

模板变量默认值

VariableValues object[] 示例值：-

模板变量值列表

Key string 示例值：vpc_name

变量名

Value object 示例值：vpc-demo123

变量值

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	InvalidParameter	The specified parameter %q is invalid.	请求参数不合法。
400	InvalidTemplate.Archive	The template archive is invalid: %s	模板归档文件不合法。
400	InvalidTemplate.Content	Failed to parse the template: %s	模板内容解析失败。
400	MissingParameter	The parameter %q is required.	缺少必填参数。
400	OperationFailed.TemplateDownload	Failed to download the template: %s	模板下载失败。
400	QuotaExceeded.TemplateSize	The template size exceeds the limit: %s	模板大小超过限制。
400	RegionNotSupport	The service [%v] not support region [%v].	服务不支持当前地域。
500	InternalError	The request has failed due to an unknown error.	内部服务错误，请稍后重试。

最近更新时间：2026.10.20 19:15:47

这个页面对您有帮助吗？

有用

无用