全部产品
Search
文档中心

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

更新时间:Nov 28, 2024

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

接口说明

前提条件

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

应用场景

跨账号创建资源栈

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

跨地域创建资源栈

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

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

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

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

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ros:CreateStackInstancescreate
*StackInstance
acs:ros:{#regionId}:{#accountId}:stackinstance/{#StackGroupName}/{#StackInstanceAccountId}/{#StackInstanceRegionId}

请求参数

名称类型必填描述示例值
RegionIdstring

资源栈组所属的地域 ID。

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

cn-hangzhou
StackGroupNamestring

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

MyStackGroup
AccountIdsarray

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

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

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

说明 您必须且仅能指定 AccountIdsDeploymentTargets其中一个参数。
["151266687691****", "141261387191****"]
RegionIdsarray

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

string

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

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

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

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

创建资源栈的操作描述。

长度为 1~256 个字符。

Create stack instances in hangzhou and beijing
OperationPreferencesobject

创建资源栈的操作设置。

包含以下参数:

  • {"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}
    TimeoutInMinuteslong

    创建资源栈的超时时间。

    • 默认值:60。

    • 单位:分钟。

    10
    DisableRollbackboolean

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

    取值:

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

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

    false
    ParameterOverridesarray<object>

    覆盖参数列表。

    object
    ParameterKeystring

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

    N 最大值为 200。

    说明
  • ParameterOverrides 为可选参数。
  • 如果需要指定 ParameterOverrides,则 ParameterOverrides.N.ParameterKey 和 ParameterOverrides.N.ParameterValue 必须同时指定。
  • Amount
    ParameterValuestring

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

    N 最大值为 200。

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

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

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

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

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

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

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

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

    说明 您可以在资源管理控制台的概览页面查看资源夹 ID。具体操作,请参见查看资源夹基本信息
    ["fd-4PvlVLOL8v"]
    AccountIdsarray

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

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

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

    说明 您可以在资源管理控制台的概览页面查看成员账号 ID。具体操作,请参见查看成员详情
    ["151266687691****","141261387191****"]
    DeploymentOptionsarray

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

    string

    可选值:

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

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

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

    请求 ID。

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

    操作 ID。

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

    示例

    正常返回示例

    JSON格式

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

    错误码

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

    变更历史

    变更时间变更内容概要操作
    2024-11-21OpenAPI 入参发生变更查看变更详情
    2024-06-17API 内部配置变更,不影响调用查看变更详情
    错误代码错误信息HTTP 状态码描述
    StackInstanceExistsThe StackInstance ({instance}) already exists.409该资源栈组在指定的目标账号和地域存在资源栈。instance 为资源栈所属的目标账号和目标地域。
    StackGroupOperationInProgressAnother Operation on StackGroup ({name}) is in progress.409资源栈组存在进行中的操作。name 为资源栈组名称。