全部產品
Search
文件中心

Resource Orchestration Service:UpdateStackInstances - 在特定帳號和地區下更新資源棧執行個體

更新時間:Dec 19, 2025

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

介面說明

本文將提供一個樣本,為杭州地區已有的自助系統管理權限模式的資源棧組MyStackGroup,在杭州地區和北京地區的阿里雲帳號151266687691****141261387191****中更新資源棧。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

ros:UpdateStackInstances

update

*StackInstance

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

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

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

cn-hangzhou

StackGroupName

string

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

MyStackGroup

AccountIds

array

使用自助系統管理權限模式部署資源棧的目標帳號 ID 列表。最多支援添加 30 個目標帳號 ID。

說明

使用自助系統管理權限模式更新資源棧時,此參數必填。

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

string

使用自助系統管理權限模式部署資源棧的目標帳號 ID 列表。最多支援添加 30 個目標帳號 ID。

說明

使用自助系統管理權限模式更新資源棧時,此參數必填。

["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 個字元。

Update 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

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

使用服務系統管理權限模式部署資源棧的部署目標。

說明

使用服務系統管理權限模式更新資源棧時,此參數必填。

RdFolderIds

array

資來源目錄的資源夾 ID 列表。

string

資來源目錄的資源夾 ID 列表。最多支援添加 20 個資源夾 ID。

您需要至少指定 RdFolderIds 和 AccountIds 其中一個參數,具體如下:

  • 如果您指定了 RdFolderIds,而未指定 AccountIds,則會在指定資源夾的所有成員帳號中部署資源棧。如果您選擇的是 Root 資源夾,則會在整個資來源目錄的所有成員帳號中部署資源棧。

  • 如果您指定了 AccountIds,而未指定 RdFolderIds,則會在指定成員帳號列表中部署資源棧。

  • 當兩者同時指定時,AccountIds 帳號需屬於 RdFolderIds 所指定的資源夾列表,則會在指定成員帳號列表中部署資源棧。

說明

您可以在資源管理控制台的概覽頁面查看資源夾 ID。具體操作,請參見查看資源夾基本資料

["fd-4PvlVLOL8v"]

AccountIds

array

資來源目錄中的成員帳號 ID 列表。最多支援添加 50 個成員帳號 ID。

說明

您可以在資源管理控制台的概覽頁面查看成員帳號 ID。具體操作,請參見查看成員詳情

string

資來源目錄中的成員帳號 ID 列表。最多支援添加 50 個成員帳號 ID。

說明

您可以在資源管理控制台的概覽頁面查看成員帳號 ID。具體操作,請參見查看成員詳情

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

關於公用請求參數的詳情,請參見公用參數

返回參數

名稱

類型

描述

樣本值

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

錯誤碼

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

變更歷史

更多資訊,參考變更詳情