CreateStackInstances - 在指定账号和地域下创建资源栈实例

为一个或多个账号在指定地域下创建资源栈实例。

接口说明

前提条件

请确保您已经创建了资源栈组。具体操作,请参见 CreateStackGroup

应用场景

跨账号创建资源栈

当某企业需要在多个账号下创建相同的资源时,为提高部署效率,管理员账号可以在创建资源栈组时,选择添加多个目标账号,部署一个地域,从而在同一地域下的不同账号中创建多个资源栈,实现在多个账号下创建相同的资源。

跨地域创建资源栈

当某企业需要在多个地域下创建相同的资源时,为提高部署效率,管理员账号可以在创建资源栈组时,选择添加一个目标账号,部署多个地域,从而在同一账号下的不同地域中创建多个资源栈,实现在多个地域下创建相同的资源。

跨账号、跨地域创建资源栈

当某企业需要在多个账号下的多个地域中创建相同的资源,为提高部署效率,管理员账号可以在创建资源栈组时,选择添加多个目标账号,部署多个地域,从而在不同账号的不同地域下创建多个资源栈,实现在多个账号下的多个地域中创建相同的资源。

本文将提供一个示例,为杭州地域已有的自助管理权限模式的资源栈组MyStackGroup,在杭州地域和北京地域的阿里云账号151266687691****141261387191****中创建资源栈。

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ros:CreateStackInstances

create

*StackInstance

acs:ros:{#regionId}:{#accountId}:stackinstance/{#StackGroupName}/{#StackInstanceAccountId}/{#StackInstanceRegionId}

请求参数

名称

类型

必填

描述

示例值

RegionId

string

资源栈组所属的地域 ID。

您可以调用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou

StackGroupName

string

资源栈组名称。名称在单个地域内唯一。
长度不超过 255 个字符,必须以数字或英文字母开头,可包含数字、英文字母、短划线(-)和下划线(_)。

MyStackGroup

AccountIds

array

使用自助管理权限模式部署资源栈的目标账号 ID 列表。最多支持添加 30 个目标账号 ID。

说明

您必须且仅能指定 AccountIdsDeploymentTargets其中一个参数。

["151266687691****","141261387191****"]

string

使用自助管理权限模式部署资源栈的目标账号 ID 列表。最多支持添加 30 个目标账号 ID。

说明

您必须且仅能指定 AccountIdsDeploymentTargets其中一个参数。

["151266687691****", "141261387191****"]

RegionIds

array

目标执行地域列表。最多支持添加 20 个地域。

["cn-hangzhou", "cn-beijing"]

string

目标执行地域列表。最多支持添加 20 个地域。

["cn-hangzhou","cn-beijing"]

ClientToken

string

保证请求的幂等性。该值由客户端生成,并且必须是全局唯一的。
长度不超过 64 个字符,可包含英文字母、数字、短划线(-)和下划线(_)。
更多信息,请参见如何保证幂等性

123e4567-e89b-12d3-a456-42665544****

OperationDescription

string

创建资源栈的操作描述。

长度为 1~256 个字符。

Create stack instances in hangzhou and beijing

OperationPreferences

object

创建资源栈的操作设置。

包含以下参数:

  • {"FailureToleranceCount": N}

    容错数。每个地域中资源栈可以失败的账号数,超过该数字将停止该地域中的操作。如果停止了一个地域中的操作,此操作在其他地域中不继续执行。

    N 的取值范围:0~20。

    若不指定 FailureToleranceCount,则默认为 0。

  • {"FailureTolerancePercentage": N}

    容错百分比。每个地域中资源栈可以失败的账号数占总账号数的百分比,超过该百分比将停止该地域中的操作。

    N 的取值范围:0~100。百分比不是整数时,ROS 会向下取整。

    若不指定 FailureTolerancePercentage,则默认为 0。

  • {"MaxConcurrentCount": N}

    最大并发账号数。每个地域中可同时部署资源栈的账号数。

    N 的取值范围:1~20。

    若不指定 MaxConcurrentCount,则默认为 1。

  • {"MaxConcurrentPercentage": N}

    最大并发账号百分比。每个地域中可同时部署资源栈的账号数占总账号数的百分比。

    取值范围:1~100。百分比不是整数时,ROS 会向下取整。

    若不指定 MaxConcurrentPercentage,则默认为 1。

  • {"RegionConcurrencyType": N}
    部署资源栈的地域级别并发类型。取值:

    • SEQUENTIAL(默认值):根据地域顺序依次在指定的每个地域部署,同一时间只在一个地域部署。

    • PARALLEL:在所有指定地域内并行部署。

多个参数之间用半角逗号(,)分隔。

说明
  • 不能同时指定 MaxConcurrentCount 和 MaxConcurrentPercentage。

  • 不能同时指定 FailureToleranceCount 和 FailureTolerancePercentage。

{"FailureToleranceCount": 1, "MaxConcurrentCount": 2}

TimeoutInMinutes

integer

创建资源栈的超时时间。

  • 默认值:60。

  • 单位:分钟。

10

DisableRollback

boolean

当创建资源栈失败时,是否禁用回滚策略。

取值:

  • true:禁用回滚,即在创建资源栈失败时不进行回滚。

  • false(默认值):不禁用回滚,即在创建资源栈失败时进行回滚。

false

ParameterOverrides

array<object>

覆盖参数列表。

object

ParameterKey

string

覆盖参数的名称。如果未指定参数名称,ROS 将使用创建资源栈组时所指定的模板参数名称。

N 最大值为 200。

说明
  • ParameterOverrides 为可选参数。

  • 如果需要指定 ParameterOverrides,则 ParameterOverrides.N.ParameterKey 和 ParameterOverrides.N.ParameterValue 必须同时指定。

Amount

ParameterValue

string

覆盖参数的值。如果未指定参数的值,ROS 将使用创建资源栈组时所指定的模板参数的值。

N 最大值为 200。

说明
  • ParameterOverrides 为可选参数。

  • 如果需要指定 ParameterOverrides,则 ParameterOverrides.N.ParameterKey 和 ParameterOverrides.N.ParameterValue 必须同时指定。

1

DeploymentTargets

object

使用服务管理权限模式部署资源栈的部署目标。

说明

您必须且仅能指定 AccountIdsDeploymentTargets其中一个参数。

{"RdFolderId": "fd-4PvlVLOL8v"}

RdFolderIds

array

资源目录的资源夹 ID 列表。最多支持添加 20 个资源夹 ID。

您可以在指定资源夹的所有成员账号中创建资源栈。如果您选择的是 Root 资源夹,则会在整个资源目录的所有成员账号中创建资源栈。

说明

您可以在资源管理控制台的概览页面查看资源夹 ID。具体操作,请参见查看资源夹基本信息

string

资源目录的资源夹 ID 列表。最多支持添加 20 个资源夹 ID。

您可以在指定资源夹的所有成员账号中创建资源栈。如果您选择的是 Root 资源夹,则会在整个资源目录的所有成员账号中创建资源栈。

说明

您可以在资源管理控制台的概览页面查看资源夹 ID。具体操作,请参见查看资源夹基本信息

["fd-4PvlVLOL8v"]

AccountIds

array

资源目录中的成员账号 ID 列表。最多支持添加 30 个成员账号 ID。

说明

您可以在资源管理控制台的概览页面查看成员账号 ID。具体操作,请参见查看成员详情。

string

资源目录中的成员账号 ID 列表。最多支持添加 30 个成员账号 ID。

说明

您可以在资源管理控制台的概览页面查看成员账号 ID。具体操作,请参见查看成员详情

["151266687691****","141261387191****"]

DeploymentOptions

array

使用服务管理权限模式部署资源栈的部署选项列表。最多支持 1 个部署选项。

string

可选值:

  • IgnoreExisting:如果要创建的资源栈实例已存在,则忽略该报错。

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

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

14A07460-EBE7-47CA-9757-12CC4761D47A

OperationId

string

操作 ID。

6da106ca-1784-4a6f-a7e1-e723863d****

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

更多信息,参考变更详情