全部產品
Search

搜尋本產品

    Cloud Config：GetAggregator - 查詢帳號組詳情

    文件中心

    Cloud Config：GetAggregator - 查詢帳號組詳情

    更新時間：Oct 15, 2025

    查詢帳號組的名稱、建立時間、成員和帳號群組類型等。

    介面說明

    本文將提供一個樣本，查詢帳號組ca-88ea626622af0055****的詳情。返回結果顯示，帳號組名稱為Test_Group、帳號組描述為測試組、帳號群組類型為CUSTOM（自訂帳號組）、帳號組狀態為1 （建立完成）等。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    config:GetAggregator

    get

    *Aggregator

    acs:config:*:{#accountId}:aggregator/{#AggregatorId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    AggregatorId

    string

    是

    帳號組 ID。

    ca-88ea626622af0055****
    Tag deprecated

    array<object>

    否

    資源的標籤。該入參已棄用，請忽略，傳入不會生效。

    最多支援綁定 20 個標籤。

    object

    否

    資源的標籤。

    最多支援綁定 20 個標籤。

    Key

    string

    否

    資源的標籤鍵。

    最多支援綁定 20 個標籤鍵。

    key-1
    Value

    string

    否

    資源的標籤值。

    最多支援綁定 20 個標籤值。

    value-1

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

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    無

    RequestId

    string

    請求 ID。

    733DD93C-2277-4905-AE0C-0BA95C04B8BC
    Aggregator

    object

    帳號組資訊。

    AggregatorCreateTimestamp

    string

    建立帳號組的時間戳記。

    單位：毫秒。

    1623034091000
    AggregatorAccounts

    array<object>

    帳號組內的成員資訊。

    object

    無

    RecorderStatus

    string

    成員的資源監控狀態。取值：

    • REGISTRABLE：未註冊。

    • BUILDING：構建中。

    • REGISTERED：登入。

    • REBUILDING：重新構建中。

    REGISTERED
    AccountId

    integer

    成員 ID。

    171322098523****
    AccountType

    string

    成員歸屬。僅支援 ResourceDirectory（資來源目錄）。

    ResourceDirectory
    AccountName

    string

    成員名稱。

    Alice
    AggregatorAccountCount

    integer

    帳號組內成員的數量。

    2
    Description

    string

    帳號組描述。

    The description of the aggregator.
    AggregatorName

    string

    帳號組名稱。

    Test_Group
    AggregatorStatus

    integer

    帳號組狀態。取值：

    • 0：建立中。

    • 1：建立完成。

    1
    AggregatorType

    string

    帳號群組類型。取值：

    • RD：全域帳號組。

    • FOLDER：資源夾帳號組。

    • CUSTOM：自訂帳號組。

    CUSTOM
    AccountId

    integer

    建立帳號組的管理帳號 ID。

    100931896542****
    AggregatorId

    string

    帳號組 ID。

    ca-88ea626622af0055****
    FolderName

    string

    資源夾帳號組綁定的資源夾名稱。多值以半形逗號分隔。

    Example-name
    Tags

    array<object>

    資源標籤。

    object

    資源標籤。

    TagKey

    string

    標籤鍵。

    key-1
    TagValue

    string

    標籤值。

    value-1
    FolderId

    string

    資源夾帳號組綁定的資源夾 ID。

    fd-brHdgv****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "733DD93C-2277-4905-AE0C-0BA95C04B8BC",
  "Aggregator": {
    "AggregatorCreateTimestamp": "1623034091000",
    "AggregatorAccounts": [
      {
        "RecorderStatus": "REGISTERED",
        "AccountId": 0,
        "AccountType": "ResourceDirectory",
        "AccountName": "Alice"
      }
    ],
    "AggregatorAccountCount": 2,
    "Description": "The description of the aggregator.",
    "AggregatorName": "Test_Group",
    "AggregatorStatus": 1,
    "AggregatorType": "CUSTOM",
    "AccountId": 0,
    "AggregatorId": "ca-88ea626622af0055****",
    "FolderName": "Example-name",
    "Tags": [
      {
        "TagKey": "key-1",
        "TagValue": "value-1"
      }
    ],
    "FolderId": "fd-brHdgv****"
  }
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 Invalid.AggregatorId.Value The specified AggregatorId is invalid. 帳號組ID不存在或無許可權使用該帳號組。
    404 AccountNotExisted Your account does not exist.
    503 ServiceUnavailable The request has failed due to a temporary failure of the server. 服務不可用。

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

    變更歷史

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