全部產品
Search

搜尋本產品

    Security Center：DescribeGroupedInstances - 查詢資產的統計資訊

    文件中心

    Security Center：DescribeGroupedInstances - 查詢資產的統計資訊

    更新時間：Mar 21, 2026

    按照指定的彙總維度去查詢資產的統計資訊。

    調試

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

    調試

    授權資訊

    當前API暫無授權資訊透出。

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Lang

    string

    否

    佈建要求和接收訊息的語言類型，預設值為 zh。取值：

    • zh：中文

    • en：英文

    zh
    MachineTypes

    string

    否

    要查詢的資產的類型。固定取值：ecs，表示雲端服務器。

    ecs
    GroupField

    string

    是

    查詢資產的過濾條件。取值：

    • groupId：表示按照資產的分組查詢。

    • regionId：表示按照資產所在的地區查詢。

    • vpcInstanceId：表示按照資產所屬的Virtual Private Cloud 查詢。

    groupId
    FieldValue

    string

    否

    要查詢的資產分組的名稱，支援模糊搜尋。

    test-01
    NoPage

    boolean

    否

    設定是否啟用分頁查詢。預設值為 true。取值：

    • true：啟用分頁查詢。

    • false：不啟用分頁查詢。

    true
    PageSize

    integer

    否

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

    20
    CurrentPage

    integer

    否

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

    1
    Vendor

    integer

    否

    伺服器廠商。取值：

    • 0：阿里雲資產

    • 1：雲外資產

    • 2：IDC 資產

    • 3、4、5、7：其它雲資產

    • 8：輕量級資產

    0
    Vendors

    string

    否

    伺服器廠商。多個廠商使用半形逗號（,）分隔。取值：

    • 0：阿里雲資產

    • 1：雲外資產

    • 2：IDC 資產

    • 3、4、5、7：其它雲資產

    • 8：輕量級資產

    0,8
    SaleVersionCheckCode

    string

    否

    查詢資產的售賣條件過濾。取值：

    • sas_gte_advanced：大於等於進階版

    • sas_gte_enterprise：大於等於企業版

    • sas_gt_basic：付費版

    • sas_eq_advanced：等於進階版

    • sas_gt_anti_virus：大於防病毒版

    sas_gt_basic

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    請求返回資料。

    RequestId

    string

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

    52A3AEE6-114A-499D-8990-4BA9B27FE0AA
    PageInfo

    object

    查詢結果的分頁資訊。

    CurrentPage

    integer

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

    5
    PageSize

    integer

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

    20
    TotalCount

    integer

    查詢到的資產資訊的總數量。

    100
    Count

    integer

    分頁查詢時，當前頁面顯示的資產的數量。

    20
    Instances

    array<object>

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

    object

    查詢到的資產資訊。

    AsapVulInstanceCount

    integer

    存在高危漏洞的資產的數量。

    11
    UnProtectedInstanceCount

    string

    未受到Security Center防護的資產的數量。

    32
    FieldAliasName

    string

    伺服器分組的名稱。

    testA
    InstanceCount

    string

    查詢時指定的資產類型下所有資產的數量。

    說明

    如果未佈建要求參數 MachineTypes，則該參數傳回值為您所有類型的資產的總數量。

    205
    RiskInstanceCount

    string

    存在安全風險的資產數量。

    172
    GroupFlag

    integer

    伺服器分組類型。取值：

    • 0：預設分組

    • 1：其他分組

    1
    AuthVersionCheckCount

    integer

    符合售賣條件的資產數量。

    205
    Os

    string

    資產系統類別型。取值：

    • windows

    • linux
      重要 該欄位僅在 Lang 為 zh 時返回。

    windows
    InstanceCoreCount

    integer

    查詢時指定的資產類型下所有資產的計算核心數。

    說明

    如果未佈建要求參數 MachineTypes，則該參數傳回值為您所有類型的資產的計算核心數。

    610

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "52A3AEE6-114A-499D-8990-4BA9B27FE0AA",
  "PageInfo": {
    "CurrentPage": 5,
    "PageSize": 20,
    "TotalCount": 100,
    "Count": 20
  },
  "Instances": [
    {
      "AsapVulInstanceCount": 11,
      "UnProtectedInstanceCount": "32",
      "FieldAliasName": "testA",
      "InstanceCount": "205",
      "RiskInstanceCount": "172",
      "GroupFlag": 1,
      "AuthVersionCheckCount": 205,
      "Os": "windows",
      "InstanceCoreCount": 610
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

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

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

    變更歷史

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