更新资源栈属性和模板

调试

API Explorer

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

去调试

请求参数

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

Action string 必选示例值：UpdateStack

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

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

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

StackID string 必选示例值：s-01kvsfjgx4bda74jjgm8tc70gx

资源栈 ID

Description string 可选示例值：update description

资源栈描述

EngineVersion string 可选示例值：terraform-1.5.7

IaC 引擎版本

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 必选示例值：env

变量名

Value object 可选示例值：prod

变量值

RoleName string 可选示例值：myrole

执行资源栈操作时使用的委托角色

DeletionProtection boolean 可选示例值：true

是否开启删除保护

DisableRollback boolean 可选示例值：false

是否禁用回滚

TimeoutInMinutes integer 可选示例值：60

执行超时时间，单位分钟；取值范围 10 到 720，不传时保留资源栈当前配置。

Parallelism integer 可选示例值：10

执行并发数，取值范围 1 到 20；不传或传 0 时不更新该配置。

返回参数

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

StackID string 示例值：s-01kvsfjgx4bda74jjgm8tc70gx

资源栈 ID

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
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].	服务不支持当前地域。
403	AccessDenied	User is not authorized to perform: %s on resource: %s	无权执行该操作。
404	EntityNotFound.Stack	The stack %q does not exist in the current region.	资源栈不存在或不属于当前地域。
404	EntityNotFound.TemplateSnapshot	The template snapshot %q does not exist.	模板快照不存在。
409	NoPermittedOperation.StackStaleRequest	The stack %q changed while the request was being prepared; reload it and retry.	资源栈在请求准备期间发生变化，请重新获取资源栈后重试。
409	NoPermittedOperation.StatusNotUpdatable	The stack %q cannot be updated in its current status %q.	资源栈当前状态不允许更新。
500	InternalError	The request has failed due to an unknown error.	内部服务错误，请稍后重试。

基础设施管理