创建资源栈集。

调试

API Explorer

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

去调试

请求参数

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

Action string 必选示例值：CreateStackSet

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

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

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

StackSetName string 必选示例值：MyStackSet

资源栈集名称，长度为 1 到 128 个字符，可包含中文、字母、数字、下划线（_）和短横线（-）；同一账号和地域下唯一。

Description string 可选示例值：my stack set

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

PermissionModel string 必选示例值：ServiceManaged

权限模式。SelfManaged 使用调用方指定的管理角色和执行角色；ServiceManaged 使用组织可信服务和服务关联角色。

AdministrationRoleName string 可选示例值：StackSetAdministrationRole

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

ExecutionRoleName string 可选示例值：StackSetExecutionRole

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

EngineVersion string 必选示例值：terraform-1.5.7

IaC 引擎版本。

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:2000000123:stack/s-01arz3ndektsv4rrffq69g5fav

来源资源栈 TRN；TemplateURL、SourceStackTRN、TemplateID、ModuleID 必须且只能选择一种来源。仅支持当前账号和当前地域的资源栈，复用其模板快照，不能同时传入 TemplatePath。

Variables object[] 可选示例值：-

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

Key string 必选示例值：Env

变量名。

Value object 可选示例值：prod

变量值。

OperationPreferences object 可选示例值：-

资源栈集默认批量操作策略；未传时默认地域顺序执行（Sequential），最大并发目标数为 1，失败容忍目标数为 0。

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

地域执行顺序。

RegionConcurrencyType string 可选示例值：Parallel

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

MaxConcurrentCount integer 可选示例值：10

单次操作最大并发目标数；与 MaxConcurrentPercentage 互斥。

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 时使用默认值 10。

返回参数

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

StackSetID string 示例值：ss-01arz3ndektsv4rrffq69g5fav

创建成功的资源栈集 ID。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	InvalidParameter	The specified parameter %q is invalid.	请求参数不合法。
400	InvalidParameter.AutoDeployment	The AutoDeployment parameter is invalid: %s	自动部署配置不合法。
400	InvalidParameter.PermissionModel	The stack set permission model %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.	资源栈不存在或不属于当前地域。
409	AlreadyExists.StackSet	A stack set named %q already exists for this account and region.	同名资源栈集已存在。
409	NoPermittedOperation.OrganizationAccessNotEnabled	The organization trusted access is not enabled.	组织可信服务未开通。
409	QuotaExceeded.StackSet	The number of stack sets has exceeded the per-account quota.	资源栈集数量超过账号配额。
500	InternalError	The request has failed due to an unknown error.	内部服务错误，请稍后重试。

基础设施管理