You need to enable JavaScript to run this app.
文档中心
基础设施管理

基础设施管理

复制全文
下载 pdf
资源栈集管理
CreateStackInstances - 创建资源栈集实例
复制全文
下载 pdf
CreateStackInstances - 创建资源栈集实例
创建资源栈集实例。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值:CreateStackInstances​
要执行的操作,取值:CreateStackInstances。​
​
Version string 必选 示例值:2026-05-01​
API的版本,取值:2026-05-01。​
​
StackSetID string 必选 示例值:ss-01arz3ndektsv4rrffq69g5fav​
资源栈集 ID。​
​
AccountIDs long[] 可选 示例值:[20001]​
SelfManaged 目标账号 ID,最多 30 个。​
​
DeploymentTargets object 可选 示例值:-​
ServiceManaged 模式的部署目标。​
AccountIDs long[] 可选 示例值:[20001]​
ServiceManaged 目标账号 ID,最多 30 个。​
​
OrganizationalUnitIDs string[] 可选 示例值:["ou-1234567890"]​
组织根或组织单元 ID,最多 20 个。​
​
​
Regions string[] 必选 示例值:["cn-beijing"]​
目标地域,最多 20 个。​
​
VariableOverrides object[] 可选 示例值:-​
实例变量覆盖。​
Key string 必选 示例值:Env​
变量名,不能为空,同一个数组内不允许重复。​
​
Value object 可选 示例值:prod​
变量值,支持 JSON 兼容类型。​
​
​
OperationPreferences object 可选 示例值:-​
操作调度策略;整体覆盖资源栈集默认策略。​
RegionOrder string[] 可选 示例值:["cn-beijing"]​
地域执行顺序,不可重复。​
​
RegionConcurrencyType string 可选 示例值:Parallel​
地域并发类型。​
​
MaxConcurrentCount integer 可选 示例值:5​
最大并发目标数,不能超过系统上限。​
​
MaxConcurrentPercentage integer 可选 示例值:50​
最大并发百分比,与 MaxConcurrentCount 不能同时传。​
​
FailureToleranceCount integer 可选 示例值:0​
失败容忍目标数。​
​
FailureTolerancePercentage integer 可选 示例值:10​
失败容忍百分比,与 FailureToleranceCount 不能同时传。​
​
​
DisableRollback boolean 可选 示例值:false​
部署失败时是否禁用自动回滚,默认 false。​
​
TimeoutInMinutes integer 可选 示例值:60​
部署操作超时时间,单位分钟,取值范围 10-720,默认 60。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
OperationID string 示例值:op-01arz3ndektsv4rrffq69g5fav​
批量创建实例操作 ID。​
​
​
​
请求示例​
​
POST /?Action=CreateStackInstances&Version=2026-05-01 HTTP/1.1​
Host: inframanager.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260910T080000Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260910/cn-beijing/inframanager/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
"StackSetID": "ss-01arz3ndektsv4rrffq69g5fav",​
"DeploymentTargets": {​
"OrganizationalUnitIDs": [​
"ou-1234567890"​
]​
},​
"Regions": [​
"cn-beijing"​
],​
"VariableOverrides": [​
{​
"Key": "Env",​
"Value": "prod"​
}​
],​
"OperationPreferences": {​
"MaxConcurrentCount": 5,​
"FailureToleranceCount": 0​
},​
"DisableRollback": false,​
"TimeoutInMinutes": 60​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20260910080000000000000000CREATE",​
"Action": "CreateStackInstances",​
"Version": "2026-05-01",​
"Service": "inframanager",​
"Region": "cn-beijing"​
},​
"Result": {​
"OperationID": "op-01arz3ndektsv4rrffq69g5fav"​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidParameter​
The specified parameter %q is invalid.​
请求参数不合法。​
400​
MissingParameter​
The parameter %q is required.​
缺少必填参数。​
400​
RegionNotSupport​
The service [%v] not support region [%v].​
服务不支持当前地域。​
404​
EntityNotFound.StackSet​
The stack set %q does not exist in the current region.​
资源栈集不存在或管理地域不匹配。​
409​
NoPermittedOperation.OrganizationAccessNotEnabled​
Trusted access is not enabled for account %q.​
管理账号尚未开通资源栈集组织访问。​
409​
NoPermittedOperation.StackSetOperationInProgress​
The stack set %q already has an active operation.​
同一资源栈集已有活跃操作。​
500​
InternalError​
The request has failed due to an unknown error.​
内部服务错误,请稍后重试。​
​
​
最近更新时间:2026.10.20 19:15:48
这个页面对您有帮助吗?
有用
有用
无用
无用