更新资源栈集；模板或变量变更后，已有实例会被标记为 Outdated。

调试

API Explorer

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

去调试

请求参数

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

Action string 必选示例值：UpdateStackSet

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

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

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

StackSetID string 必选示例值：ss-01arz3ndektsv4rrffq69g5fav

要更新的资源栈集 ID。

Description string 可选示例值：update description

新的资源栈集描述，长度不超过 256。

AdministrationRoleName string 可选示例值：StackSetAdministrationRole

管理账号角色名；SelfManaged 模式可填，ServiceManaged 模式必须为空。

ExecutionRoleName string 可选示例值：StackSetExecutionRole

目标账号执行角色名；SelfManaged 模式可填，ServiceManaged 模式必须为空。

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

模板 URL，支持 HTTP、HTTPS 或 tos:// 来源，模板最大为 5 MB。TemplateURL、SourceStackTRN、TemplateID、ModuleID 互斥，最多传入一种来源；均不传时保留现有模板来源。

TemplatePath string 可选示例值：/

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

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

在线模板 ID。TemplateURL、SourceStackTRN、TemplateID、ModuleID 互斥，最多传入一种来源；均不传时保留现有模板来源。传入时必须同时指定 TemplateVersion。

TemplateVersion long 可选示例值：1

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

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

公共 Module ID。TemplateURL、SourceStackTRN、TemplateID、ModuleID 互斥，最多传入一种来源；均不传时保留现有模板来源。传入时必须同时指定 ModuleVersion 和非根目录 TemplatePath。

ModuleVersion long 可选示例值：1

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

SourceStackTRN string 可选示例值：trn:inframanager:cn-beijing:10001:stack/s-01arz3ndektsv4rrffq69g5fav

来源资源栈 TRN；TemplateURL、SourceStackTRN、TemplateID、ModuleID 互斥，最多传入一种来源；均不传时保留现有模板来源。仅支持当前账号和当前地域的资源栈，复用其模板快照，不能同时传入 TemplatePath。

Variables object[] 可选示例值：-

新的资源栈集模板变量值列表；变量名不能为空且同一数组内不允许重复。

Key string 必选示例值：Env

变量名。

Value object 可选示例值：staging

变量值。

EngineVersion string 可选示例值：terraform-1.5.7

新的 IaC 引擎版本；传空字符串时不更新该配置。

OperationPreferences object 可选示例值：-

新的资源栈集默认批量操作策略；传入后整体替换原策略。

RegionOrder string[] 可选示例值：["cn-beijing"]

地域执行顺序，按数组顺序调度指定地域；数组内不允许重复或空字符串。

RegionConcurrencyType string 可选示例值：Parallel

地域并发方式，取值为 Sequential 或 Parallel；默认 Sequential。

MaxConcurrentCount integer 可选示例值：10

单次操作最大并发目标数；与 MaxConcurrentPercentage 互斥。两者均未传入时默认 1。

MaxConcurrentPercentage integer 可选示例值：50

单次操作最大并发目标百分比，取值范围 1 到 100；与 MaxConcurrentCount 互斥。

FailureToleranceCount integer 可选示例值：0

失败容忍目标数，取值不小于 0；与 FailureTolerancePercentage 互斥。未传并且未传百分比时默认 0。

FailureTolerancePercentage integer 可选示例值：10

失败容忍目标百分比，取值范围 0 到 100；与 FailureToleranceCount 互斥。

AutoDeployment object 可选示例值：-

新的 ServiceManaged 自动部署配置；SelfManaged 模式不允许传入。

Enabled boolean 可选示例值：true

是否对后续加入组织或组织单元的成员账号自动创建资源栈集实例。

RetainStacksOnAccountRemoval boolean 可选示例值：true

成员账号移出组织或组织单元后，是否保留该账号下已自动创建的资源栈；未传时默认 true。仅当 AutoDeployment.Enabled 为 true 时生效。

Parallelism integer 可选示例值：10

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

返回参数

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

StackSetID string 示例值：ss-01arz3ndektsv4rrffq69g5fav

更新成功的资源栈集 ID。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	InvalidParameter	The specified parameter %q is invalid.	请求参数不合法。
400	InvalidParameter.AutoDeployment	The AutoDeployment parameter is invalid: %s	自动部署配置不合法。
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].	服务不支持当前地域。
404	EntityNotFound.Stack	The stack %q does not exist in the current region.	资源栈不存在或不属于当前地域。
404	EntityNotFound.StackSet	The stack set %q does not exist in the current region.	资源栈集不存在或不属于当前地域。
404	EntityNotFound.TemplateSnapshot	The template snapshot %q does not exist.	模板快照不存在。
409	NoPermittedOperation.OrganizationAccessNotEnabled	The organization trusted access is not enabled.	组织可信服务未开通。
409	NoPermittedOperation.StackSetStaleRequest	The stack set %q changed while the request was being prepared; reload it and retry.	资源栈集在请求准备期间发生变化，请重新查询后重试。
500	InternalError	The request has failed due to an unknown error.	内部服务错误，请稍后重试。

基础设施管理