全部產品
Search

搜尋本產品

    Security Center：DescribeGroupedContainerInstances - 查詢容器列表資訊

    文件中心

    Security Center：DescribeGroupedContainerInstances - 查詢容器列表資訊

    更新時間：Mar 21, 2026

    根據分組類型查詢對應的容器列表資訊。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-sas:DescribeGroupedContainerInstances

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Criteria

    string

    否

    設定搜尋資產的條件。該參數為 JSON 格式，多個條件之間使用半形逗號（,）分隔。例如：[{"name":"riskStatus","value":"YES"},{"name":"riskLevel","value":"2"}]。

    說明

    支援使用執行個體 ID、執行個體名稱、所屬 VPC ID、地區、公網 IP 位址等條件搜尋資產。您可以調用 DescribeCriteria 查詢支援的搜尋條件。

    [{"name":"riskStatus","value":"YES"},{"name":"riskLevel","value":"2"}]
    LogicalExp

    string

    否

    設定多個搜尋條件間生效的邏輯關係。取值：

    • OR：表示多個條件間為或的關係。

    • AND：表示多個條件間為與的關係。

    OR
    GroupField

    string

    是

    要查詢的分組類型。取值：

    • pod：容器組。

    • appName：應用程式名稱。

    • namespace：命名空間。

    • clusterId：叢集 ID。

    • image：鏡像。

    pod
    FieldValue

    string

    否

    設定不同分組類型的搜尋條件。根據 GroupField 選擇的類型您需要設定以下搜尋條件：

    • GroupField 選擇為 pod：指定要查詢的容器組名稱。

    • GroupField 選擇為 appName：指定要查詢的應用程式名稱。

    • GroupField 選擇為 namespace：指定要查詢的命名空間。

    • GroupField 選擇為 clusterId：指定要查詢的叢集 ID。

    • GroupField 選擇為 image：指定要查詢的鏡像名稱。

    說明

    以上搜尋條件均支援模糊搜尋。

    cas-adad-qeqwe
    PageSize

    integer

    否

    設定分頁查詢時，每頁顯示的容器資產的數量。預設值為 20，表示每頁顯示 20 條容器資產資訊。

    說明

    建議 PageSize 取值不要為空白。

    20
    CurrentPage

    integer

    否

    設定從返回結果的第幾頁開始顯示查詢結果。預設值為 1，表示從第 1 頁開始顯示。

    1

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    本次調用請求的 ID，是由阿里雲為該請求產生的唯一識別碼，可用於排查和定位問題。

    4E5BFDCF-B9DD-430D-9DA4-151BCB581C9D
    PageInfo

    object

    資料分頁資訊。

    CurrentPage

    integer

    分頁查詢時，當前頁的頁碼。

    1
    PageSize

    integer

    分頁查詢時，每頁顯示的容器資產的數量。預設值為 20，表示每頁顯示 20 條容器資產資訊。

    20
    TotalCount

    integer

    查詢到的容器資產的總數量。

    25
    Count

    integer

    分頁查詢時，當前頁顯示的容器資產資訊的條數。

    20
    GroupedContainerInstanceList

    array<object>

    查詢到的容器資產資訊的列表。

    object

    容器資產資訊。

    RiskLevel

    string

    風險的等級。取值：

    • high：高危

    • medium：中危

    • low：低危

    low
    HostIp

    string

    容器叢集的主機 IP。

    172.114.XX.XX
    Pod

    string

    容器組名稱。

    csi-plugin-2n****
    RiskStatus

    string

    風險狀態。取值：

    • NO：無風險。

    • YES：有風險。

    NO
    CreateTime

    integer

    建立叢集時間戳記，單位為毫秒。

    1600076893000
    Namespace

    string

    叢集的命名空間。

    kube-system
    CusterState

    string

    叢集的運行狀態。取值：

    • running：叢集正在運行。

    • stopped：叢集已經停止運行。

    • deleted：叢集已經被刪除。

    • delete_failed：刪除叢集失敗。

    • failed：建立叢集失敗。

    running
    InstanceId

    string

    伺服器執行個體的 ID。

    i-8vb9ul5xec4tua4q****
    RegionId

    string

    執行個體所在的地區的 ID。

    cn-hangzhou
    AppName

    string

    應用程式名稱。

    oss-liveness-probe
    InstanceCount

    integer

    查詢到的容器組數量、應用數量、叢集數量或命名空間數量。

    9
    ClusterType

    string

    叢集的類型。取值：

    • Kubernetes：Kubernetes 專有版。

    • ManagedKubernetes：標準託管叢集（邊緣叢集）。

    • Ask：標準 Serverless 叢集。

    ManagedKubernetes
    ClusterName

    string

    叢集名稱。

    test
    PodIp

    string

    容器組 IP。

    172.114.XX.XX
    VulCount

    integer

    在當前容器組、應用、命名空間或叢集中檢測出的漏洞數量。

    1
    AlarmCount

    integer

    在當前容器組、應用、命名空間或叢集中檢測出的警示數量。

    1
    RiskInstanceCount

    integer

    存在風險的執行個體數量。

    1
    ClusterId

    string

    叢集 ID。

    cf3824769c85441b4bf3****
    Image

    string

    容器鏡像。

    registry-vpc.ap-southeast-5.aliyuncs.com/log-service-release/sls-connector:1.1.77
    ImageRepoNamespace

    string

    鏡像倉庫命名空間。

    name001
    ImageRepoName

    string

    鏡像倉庫名稱。

    test-003
    ImageRepoTag

    string

    鏡像倉庫標籤。

    dev-20220512-2
    ImageDigest

    string

    鏡像 digest 值。

    58e58c013f70bbfde140c8a55c1078074b3483479428d4069aa946827fd566cf
    ImageUuid

    string

    鏡像 UUID。

    e4bdec1d9ba7e0967111a7ea467c****
    HcCount

    integer

    在當前容器組、應用、命名空間或叢集中檢測出的基準總數。

    20
    SyncOpen

    integer

    叢集日誌審計同步開關。取值：

    • 0：關閉。

    • 1：開啟。

    1
    SyncStatus

    integer

    叢集日誌審計同步狀態。取值：

    • 0：同步失敗。

    • 1：同步成功。

    1

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "4E5BFDCF-B9DD-430D-9DA4-151BCB581C9D",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 25,
    "Count": 20
  },
  "GroupedContainerInstanceList": [
    {
      "RiskLevel": "low",
      "HostIp": "172.114.XX.XX",
      "Pod": "csi-plugin-2n****",
      "RiskStatus": "NO",
      "CreateTime": 1600076893000,
      "Namespace": "kube-system",
      "CusterState": "running",
      "InstanceId": "i-8vb9ul5xec4tua4q****",
      "RegionId": "cn-hangzhou",
      "AppName": "oss-liveness-probe",
      "InstanceCount": 9,
      "ClusterType": "ManagedKubernetes",
      "ClusterName": "test",
      "PodIp": "172.114.XX.XX",
      "VulCount": 1,
      "AlarmCount": 1,
      "RiskInstanceCount": 1,
      "ClusterId": "cf3824769c85441b4bf3****",
      "Image": "registry-vpc.ap-southeast-5.aliyuncs.com/log-service-release/sls-connector:1.1.77",
      "ImageRepoNamespace": "name001",
      "ImageRepoName": "test-003",
      "ImageRepoTag": "dev-20220512-2",
      "ImageDigest": "58e58c013f70bbfde140c8a55c1078074b3483479428d4069aa946827fd566cf",
      "ImageUuid": "e4bdec1d9ba7e0967111a7ea467c****",
      "HcCount": 20,
      "SyncOpen": 1,
      "SyncStatus": 1
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 IllegalParam Illegal param 無效參數
    500 ServerError ServerError 服務故障，請稍後重試！
    403 NoPermission caller has no permission 當前操作未被授權，請聯絡主帳號在RAM控制台進行授權後再執行操作。

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

    變更歷史

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