全部產品
Search
文件中心

Resource Orchestration Service:ListStackGroups - 查詢資源棧組列表

更新時間:Jun 04, 2026

在一個阿里雲地區下查詢資源棧組列表詳情。

介面說明

本文將提供一個樣本,查詢杭州地區處於啟用狀態的資源棧組列表。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

ros:ListStackGroups

get

*StackGroup

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

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

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

cn-hangzhou

Status

string

資源棧組狀態。如果未指定,則查詢該地區下所有狀態的資源棧組。

取值:

  • ACTIVE:已啟用。

  • DELETED:已刪除。

ACTIVE

PageSize

integer

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

  • 取值範圍:1~50。

  • 預設值:10。

10

PageNumber

integer

分頁查詢時設定的頁碼。

  • 起始值:1。

  • 預設值:1。

1

ResourceGroupId

string

資源群組 ID。如果未指定,則查詢所有資源群組中的資源棧組。

說明

資源群組 ID 可以從資源管理控制台的資源群組頁面下擷取。具體操作,請參見查看資源群組基本資料

rg-acfmzawhxxcj****

Tags

array<object>

資源棧組的標籤。

object

Key

string

資源棧組的標籤鍵。

說明

Tags 為選擇性參數。如果需要指定 Tags,則 Tags.N.Key 必須指定。

usage

Value

string

資源棧組的標籤值。

test

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

返回參數

名稱

類型

描述

樣本值

object

StackGroups

array<object>

資源棧組列表。

array<object>

StackGroupId

string

資源棧組 ID。

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

Status

string

資源棧組狀態。

取值:

  • ACTIVE:已啟用。

  • DELETED:已刪除。

ACTIVE

DriftDetectionTime

string

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

2020-02-27T07:47:47

Description

string

資源棧組描述。

My Stack Group

StackGroupDriftStatus

string

資源棧組在最近一次成功執行的偏差檢測中的偏差狀態。

取值:

  • DRIFTED:存在偏差。

  • NOT_CHECKED:未檢測偏差。

  • IN_SYNC:不存在偏差。

IN_SYNC

StackGroupName

string

資源棧組名稱。

MyStackGroup

Tags

array<object>

資源棧組的標籤。

object

Key

string

資源棧組的標籤鍵。

usage1

Value

string

資源棧組的標籤值。

test1

ResourceGroupId

string

資源群組 ID。

rg-acfmzawhxxcj****

PermissionModel

string

授權模式。

取值:

  • SELF_MANAGED:自助系統管理權限模式。

  • SERVICE_MANAGED:服務系統管理權限模式。

說明

關於資源棧組的授權模式,請參見概覽

SELF_MANAGED

AutoDeployment

object

自動部署設定資訊。

Enabled

boolean

啟用或者禁用自動部署。

取值:

  • true:啟用自動部署。啟用自動部署後,如果目標資源夾中新增了成員帳號,資源棧組會自動將資源棧執行個體部署到目標資源夾中新增賬戶的指定地區下。如果從目標資源夾中刪除賬戶,資源棧組將從此賬戶的指定地區中刪除資源棧執行個體。

  • false:禁用自動部署。禁用自動部署後,目標資源夾中成員帳號變動時資源棧執行個體不會發生變化。

true

RetainStacksOnAccountRemoval

boolean

目標資源夾中刪除成員帳號時,是否保留成員帳號中的資源棧。

取值:

  • true:保留資源棧。

  • false:刪除資源棧。

說明

僅當 Enabled 返回 true 時,才會返回 RetainStacksOnAccountRemoval。

true

CreateTime

string

資源棧組建立時間。

2024-01-05T05:38:31

UpdateTime

string

資源棧組更新時間。

2024-02-15T16:40:25

TotalCount

integer

資源棧組總數。

1

RequestId

string

請求 ID。

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

PageSize

integer

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

10

PageNumber

integer

分頁查詢時設定的頁碼。

1

樣本

正常返回樣本

JSON格式

{
  "StackGroups": [
    {
      "StackGroupId": "fd0ddef9-9540-4b42-a464-94f77835****",
      "Status": "ACTIVE",
      "DriftDetectionTime": "2020-02-27T07:47:47",
      "Description": "My Stack Group",
      "StackGroupDriftStatus": "IN_SYNC",
      "StackGroupName": "MyStackGroup",
      "Tags": [
        {
          "Key": "usage1",
          "Value": "test1"
        }
      ],
      "ResourceGroupId": "rg-acfmzawhxxcj****",
      "PermissionModel": "SELF_MANAGED",
      "AutoDeployment": {
        "Enabled": true,
        "RetainStacksOnAccountRemoval": true
      },
      "CreateTime": "2024-01-05T05:38:31",
      "UpdateTime": "2024-02-15T16:40:25"
    }
  ],
  "TotalCount": 1,
  "RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "PageSize": 10,
  "PageNumber": 1
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情