调用UpdateStackInstances接口在指定阿里云账号和地域下更新资源栈实例。

如果您更新了资源栈组（例如：更新了资源栈组的模板），您可以调用UpdateStackInstances接口更新该资源栈组的资源栈实例，此时资源栈实例对应的资源栈模板将进行更新。

本文将提供一个示例，为您更新杭州地域名为MyStackGroup的资源栈组在杭州和北京地域151266687691****和141261387191****阿里云账号下的资源栈实例。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 UpdateStackInstances

要执行的操作，取值：UpdateStackInstances。
AccountIds Json 是 ["151266687691****","141261387191****"]

目标执行阿里云账号列表。最多可以指定20个阿里云账号。
ParameterOverrides.N.ParameterKey String 是 Amount

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

N最大值为200。

说明
  • ParameterOverrides为可选参数。
  • 如果需要指定ParameterOverrides，则ParameterOverrides.N.ParameterKey和ParameterOverrides.N.ParameterValue必须同时指定。
ParameterOverrides.N.ParameterValue String 是 1

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

N最大值为200。

说明
  • ParameterOverrides为可选参数。
  • 如果需要指定ParameterOverrides，则ParameterOverrides.N.ParameterKey和ParameterOverrides.N.ParameterValue必须同时指定。
RegionId String 是 cn-hangzhou

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

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

目标执行地域列表。最多可以指定20个地域。
StackGroupName String 是 MyStackGroup

资源栈组名称。名称在单个地域内唯一。

长度不超过255个字符，必须以数字或英文字母开头，可以包含数字、英文字母、短划线（-）和下划线（_）。
ClientToken String 否 123e4567-e89b-12d3-a456-42665544****

保证请求的幂等性。该值由客户端生成，并且必须是全局唯一的。

长度不超过64个字符，可包含英文字母、数字、短划线（-）和下划线（_）。

更多详情，请参见如何保证幂等性。

OperationDescription String 否 Update stack instances in hangzhou and beijing

操作描述。

取值范围：1~256个字符。
OperationPreferences Json 否 {"FailureToleranceCount": 1, "MaxConcurrentCount": 2}

操作设置。可包含如下字段：

  • FailureToleranceCount

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

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

取值范围：0~20。

  • FailureTolerancePercentage

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

不能同时指定FailureToleranceCount和FailureTolerancePercentage。

取值范围：0~100。

  • MaxConcurrentCount

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

不能同时指定MaxConcurrentCount和MaxConcurrentPercentage。

取值范围：1~20。

  • MaxConcurrentPercentage

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

不能同时指定MaxConcurrentCount和MaxConcurrentPercentage。

取值范围：1~100。
TimeoutInMinutes Long 否 10

创建资源栈的超时时间。

默认值：60。

单位：分钟。

关于公共请求参数的详情，请参见公共参数。

返回数据

名称 类型 示例值 描述
OperationId String 6da106ca-1784-4a6f-a7e1-e723863d****

操作ID。
RequestId String 14A07460-EBE7-47CA-9757-12CC4761D47A

请求ID。

示例

请求示例

http(s)://ros.aliyuncs.com/?Action=UpdateStackInstances
&AccountIds=["151266687691****","141261387191****"]
&RegionId=cn-hangzhou
&RegionIds=["cn-hangzhou", "cn-beijing"]
&StackGroupName=MyStackGroup
&<公共请求参数>

正常返回示例

XML格式 

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

JSON格式 

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

错误码

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

错误代码

错误信息

HTTP状态码

描述

InvalidParameter

The specified parameter {name} is invalid, {reason}.

400

无效参数，name为参数名，reason为原因。

StackGroupNotFound

The StackGroup ({name}) could not be found.

404

资源栈组不存在。name为资源栈组名称。

StackGroupOperationInProgress

Another Operation on StackGroup ({name}) is in progress.

409

资源栈组存在进行中的操作。name为资源栈组名称。