全部產品
Search
文件中心

Resource Orchestration Service:CreateStackInstances - 在指定帳號和地區下建立資源棧執行個體

更新時間:Dec 19, 2025

為一個或多個帳號在指定地區下建立資源棧執行個體。

介面說明

前提條件

請確保您已經建立了資源棧組。具體操作,請參見 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 列表。最多支援添加 50 個目標帳號 ID。

說明

您必須且僅能指定 AccountIdsDeploymentTargets其中一個參數。

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

string

使用自助系統管理權限模式部署資源棧的目標帳號 ID 列表。最多支援添加 50 個目標帳號 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****"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情