调用CreateStackInstances接口在特定账号和地域下创建资源栈实例。

资源栈实例是指特定账号和地域中的资源栈。账号和地域是必填参数——您必须至少指定一个账号和一个地域。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
AccountIds Json 是 ["123456"]

目标执行账号列表。类型为Json列表。列表长度不超过20。
ParameterOverrides.N.ParameterKey String 是 Amount

覆盖参数的名称。 如果未指定特定参数的名称和值，ROS将使用创建资源栈组时所指定的参数。

N最大值为200。
ParameterOverrides.N.ParameterValue String 是 1

覆盖参数的值。如果未指定特定参数的名称和值，ROS将使用创建资源栈组时所指定的参数。

N最大值为200。
RegionId String 是 cn-hangzhou

资源栈所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

RegionIds Json 是 ["cn-hangzhou", "cn-beijing"]

目标执行地域列表。类型为Json列表。列表长度不超过20。
StackGroupName String 是 MyStackGroup

资源栈组名称。名称在单个Region内唯一，可以包含数字、英文字母（区分大小写）、连字符、下划线。必须以数字或英文字母开头，且长度不超过255个字符。
ClientToken String 否 123e4567-e89b-12d3-a456-426655440000

保证请求的幂等性。 该值由客户端生成，并且必须是全局唯一的。 仅允许使用英文字母（区分大小写）、数字、字符、连字符和下划线。它最多可包含64个字符。更多详情，请参见如何保证幂等性。

OperationDescription String 否 Create stack instances in hangzhou and beijing

操作描述。描述该操作的目的或行为。

长度限制：1~256个字符。
OperationPreferences Json 否 {"FailureToleranceCount": 1, "MaxConcurrentCount": 2}

操作设置。类型为Json字典。可包含如下字段：

  • FailureToleranceCount

失败容错数。一个资源栈组操作中，若操作结果的失败总数不超过失败容错数，操作则成功，反之则失败。

若不指定FailureToleranceCount，则默认为0。不能同时指定FailureToleranceCount和FailureTolerancePercentage。

范围限制：0~20

  • FailureTolerancePercentage

失败容错百分比。一个资源栈组操作中，若操作结果的失败百分比不超过失败容错百分比，操作则成功，反之则失败。

不能同时指定FailureToleranceCount和FailureTolerancePercentage。

范围限制：0~100

  • MaxConcurrentCount

最大账号并发数。一个资源栈组操作中，最多能有多少个账号同时执行。

不能同时指定MaxConcurrentCount和MaxConcurrentPercentage。

范围限制：1~20

  • MaxConcurrentPercentage

最大账号并发百分比。一个资源栈组操作中，最多能有多少百分比的账号同时执行。

不能同时指定FailureToleranceCount和FailureTolerancePercentage。

范围限制：1~100

返回数据

名称 类型 示例值 描述
RequestId String 14A07460-EBE7-47CA-9757-12CC4761D47A

请求ID。
OperationId String 6da106ca-1784-4a6f-a7e1-e723863dc75a

操作ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateStackInstances
&AccountIds=["123456"]
&ParameterOverrides.1.ParameterKey=Amount
&ParameterOverrides.1.ParameterValue=1
&RegionId=cn-hangzhou
&RegionIds=["cn-hangzhou", "cn-beijing"]
&StackGroupName=MyStackGroup
&<公共请求参数>

正常返回示例

XML 格式 

<RequestId>14A07460-EBE7-47CA-9757-12CC4761D47A</RequestId>
<OperationId>6da106ca-1784-4a6f-a7e1-e723863dc75a</OperationId>

JSON 格式 

{
    "RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
    "OperationId": "6da106ca-1784-4a6f-a7e1-e723863dc75a"
}

错误码

访问错误中心查看更多错误码。