全部產品
Search

搜尋本產品

    Resource Orchestration Service：ListStackInstances - 查詢指定資源棧組關聯的資源棧執行個體列表

    文件中心

    Resource Orchestration Service：ListStackInstances - 查詢指定資源棧組關聯的資源棧執行個體列表

    更新時間：Jun 04, 2026

    在一個阿里雲地區下查詢指定資源棧組關聯的資源棧執行個體列表詳情。

    介面說明

    本文將提供一個樣本，查詢杭州地區已有的自助系統管理權限模式的資源棧組MyStackGroup下的資源棧列表。

    調試

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

    調試

    授權資訊

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

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

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ros:ListStackInstances

    get

    *StackInstance

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

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

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

    cn-hangzhou
    StackGroupName

    string

    是

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

    MyStackGroup
    StackInstanceAccountId

    string

    否

    資源棧所屬目標帳號 ID。

    • 自助系統管理權限模式下，該帳號是阿里雲帳號。

    • 服務系統管理權限模式下，該帳號是資來源目錄的成員帳號。

    說明

    關於目標帳號的更多資訊，請參見概覽。

    156552876021****
    StackInstanceRegionId

    string

    否

    資源棧所屬地區。

    cn-beijing
    PageSize

    integer

    否

    分頁查詢時設定的每頁行數。

    • 取值範圍：1~50。

    • 預設值：10。

    10
    PageNumber

    integer

    否

    分頁查詢時設定的頁碼。

    • 起始值：1。

    • 預設值：1。

    1

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

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    TotalCount

    integer

    資源棧總數。

    1
    RequestId

    string

    請求 ID。

    85DE34BD-7FF9-480F-8C21-556E9DA93ACD
    PageSize

    integer

    分頁查詢時設定的每頁行數。

    1
    PageNumber

    integer

    分頁查詢時設定的頁碼。

    1
    StackInstances

    array<object>

    資源棧列表。

    object

    Status

    string

    資源棧的狀態。

    取值：

    • CURRENT：資源棧是最新的。

    • OUTDATED：資源棧不是資源棧組最新的。可能存在如下原因：

      • 在建立資源棧（CreateStackInstances）操作期間，建立對應的資源棧失敗。

      • 在更新資源棧（UpdateStackInstances 或 UpdateStackGroup）操作期間，更新對應的資源棧失敗，或只更新了部分資源棧。

      • 建立或更新操作未完成。

    CURRENT
    StackGroupId

    string

    資源棧組 ID。

    fd0ddef9-9540-4b42-a464-94f77835****
    StackId

    string

    資源棧所對應的資源棧 ID。

    說明

    僅當資源棧狀態為 CURRENT 時，才會返回該參數。

    35ad60e3-6a92-42d8-8812-f0700d45****
    DriftDetectionTime

    string

    資源棧最近一次成功完成偏差檢測的時間。

    說明

    僅當資源棧組做過偏差檢測，才會返回該參數。

    2020-02-27T07:47:47
    StackDriftStatus

    string

    最近一次成功完成偏差檢測的資源棧的狀態。

    取值：

    • DRIFTED：資源棧處於偏差狀態。

    • NOT_CHECKED：資源棧未進行過成功的偏差檢測。

    • IN_SYNC：資源棧處於同步狀態。

    說明

    僅當資源棧組做過偏差檢測，才會返回該參數。

    IN_SYNC
    StatusReason

    string

    狀態原因描述。

    說明

    僅當資源棧的執行個體狀態為 OUTDATED 時，才會返回該參數。

    User initiated stop
    StackGroupName

    string

    資源棧組名稱。

    MyStackGroup
    AccountId

    string

    資源棧所屬目標帳號 ID。

    156552876021****
    RegionId

    string

    資源棧所屬地區。

    cn-beijing
    RdFolderId

    string

    資來源目錄的資源夾 ID。

    說明

    僅限使用服務系統管理權限模式的資源棧組，才會返回該參數。

    fd-4PvlVLOL8v

    樣本

    正常返回樣本

    JSON格式

    {
  "TotalCount": 1,
  "RequestId": "85DE34BD-7FF9-480F-8C21-556E9DA93ACD",
  "PageSize": 1,
  "PageNumber": 1,
  "StackInstances": [
    {
      "Status": "CURRENT",
      "StackGroupId": "fd0ddef9-9540-4b42-a464-94f77835****",
      "StackId": "35ad60e3-6a92-42d8-8812-f0700d45****",
      "DriftDetectionTime": "2020-02-27T07:47:47",
      "StackDriftStatus": "IN_SYNC",
      "StatusReason": "User initiated stop",
      "StackGroupName": "MyStackGroup",
      "AccountId": "156552876021****",
      "RegionId": "cn-beijing",
      "RdFolderId": "fd-4PvlVLOL8v"
    }
  ]
}

    錯誤碼

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

    變更歷史

    更多資訊，參考變更詳情。