全部產品
Search
文件中心

Resource Orchestration Service:ImportStacksToStackGroup - 將資源棧匯入至資源棧組

更新時間:Jun 04, 2026

將多個不同帳號下的資源棧匯入至資源棧組。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ros:ImportStacksToStackGroup

create

*StackGroup

acs:ros:{#regionId}:{#accountId}:stackgroup/{#StackGroupName}

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

資源棧組所屬的地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。

cn-hangzhou

StackGroupName

string

資源棧組名稱。名稱在單個地區內唯一。 長度不超過 255 個字元,必須以數字或英文字母開頭,可包含數字、英文字母、短劃線(-)和底線(_)。

MyStackGroup

StackArns

array

要匯入到資源棧組中的資源棧的 ARN 列表,形如 acs:ros:${RegionId}:${AccountId}:stack/${StackId}。最多支援添加 10 個。

string

要匯入到資源棧組中的資源棧的 ARN,形如 acs:ros:${RegionId}:${AccountId}:stack/${StackId}。最多支援添加 10 個。

acs:ros:cn-hangzhou:175458000000****:stack/4a65f506-c3cc-43b6-af06-3f000000****

ResourceDirectoryFolderIds

array

要匯入的資源棧所屬的資來源目錄的資源夾 ID 列表。最多支援添加 10 個。

string

要匯入的資源棧所屬的資來源目錄的資源夾 ID。最多支援添加 10 個。

["fd-1111VL****"]

ClientToken

string

保證請求的等冪性。該值由用戶端產生,並且必須是全域唯一的。
長度不超過 64 個字元,可包含英文字母、數字、短劃線(-)和底線(_)。
更多資訊,請參見如何保證等冪性

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

OperationDescription

string

操作描述。

Import ops stacks to stack group

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}最大並發帳號百分比。

    每個地區中可同時部署資源棧的帳號數佔總帳號數的百分比。

    N 的取值範圍:1~100。百分比不是整數時,ROS 會向下取整。

    若不指定 MaxConcurrentPercentage,則預設為 1。

  • {"RegionConcurrencyType": N} 部署資源棧執行個體的地區層級並發類型,取值:

    • SEQUENTIAL (預設值): 根據地區順序依次在指定的每個地區部署,同一時間只在一個地區部署。

    • PARALLEL :在所有指定的地區內並行部署。

多個參數之間用半形逗號(,)分隔。

說明
  • 不能同時指定 MaxConcurrentCount 和 MaxConcurrentPercentage。

  • 不能同時指定 FailureToleranceCount 和 FailureTolerancePercentage。

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

返回參數

名稱

類型

描述

樣本值

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****"
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情