全部產品
Search

搜尋本產品

    Security Center：DescribeCriteria - 查詢資產時的查詢條件

    文件中心

    Security Center：DescribeCriteria - 查詢資產時的查詢條件

    更新時間：Mar 21, 2026

    查詢資產時能顯示的資產屬性模糊比對的查詢條件。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-sas:DescribeCriteria

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    MachineTypes

    string

    否

    查詢的資產類型。取值：

    • ecs ：表示查詢所有 ECS 伺服器。

    ecs
    Value

    string

    否

    查詢資產時輸入的模糊比對值。

    47.96
    SupportAutoTag

    boolean

    否

    設定輸入的模糊查詢欄位是否支援自動匹配。預設 false，取值：

    • true：是。

    • false：否。

    true

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    請求返回資料。

    RequestId

    string

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

    8E6DDACF-99AF-5939-AFFD-FCCD3B01E724
    CriteriaList

    array<object>

    資產查詢條件的資訊列表。

    object

    資產查詢條件的資訊。

    Type

    string

    查詢條件的類型。取值：

    • input：需要手動輸入查詢欄位。

    • select：需要從下拉式清單中選取查詢條件的子類型。

    input
    Name

    string

    對應的查詢條件的名稱。

    • internetIp：公網 IP。

    • intranetIp：私網 IP。

    • instanceName：執行個體名稱。

    • instanceId：執行個體 ID。

    • machineType：執行個體類型。

    • clusterIdList：叢集 ID 列表。

    • vpcInstanceId：所屬 VPC ID。

    • osName：作業系統。

    • osType：系統類別型。

    • hcStatus：是否有基準問題。

    • vulStatus：是否有漏洞問題。

    • asapVulStatus：是否存在緊急漏洞。

    • alarmStatus：是否有安全警示。

    • riskStatus：是否存在風險。

    • clientStatus：是否線上。

    • clientSubStatus：用戶端子狀態。

    • runningStatus：開機狀態。

    • tagName：標籤名稱。

    • vendorAuthAlias：授權帳號備忘。

    • vendorUid：授權帳號 ID。

    • vendorUserName：授權帳號名稱。

    • namespace：命名空間。

    • appName：應用程式名稱。

    • groupName：分組名稱。

    • regionId：地區。

    • groupId：分組 ID。

    • newInstance：是否新增資產。

    • containerStatus：是否存在容器。

    • importance：資產重要性。

    • exposedStatus：是否是暴露伺服器。

    • clusterId：叢集 ID。

    • authVersion：授權版本。

    • flag：雲廠商。

    • ipList：IP 列表。

    • uuidList：UUID。

    • aiStatus：是否存在 AI 組件。

    • tagKeyValue：ECS 標籤。

    • ecsType：伺服器類型。

    • alisecguardStatus：自保護狀態。

    • alihipsStatus：AliHips 狀態。

    • alinetStatus：AliNet 狀態。

    • alidetectStatus：端引擎狀態。

    • yundunMonitorStatus：資訊採集組件狀態。

    • clusterNodeStatus：是否叢集節點。

    internetIp
    Values

    string

    輸入的模糊比對值對應的資產的具體屬性值。

    說明

    • 當 Name 返回為 machineType 時，枚舉值為：

    說明

    • 38：Elastic Container Instance。

    • 51：RunD 容器執行個體。

    • 52：RunC 容器執行個體。

    • 當 Name 返回為 osType 時，枚舉值為：

    說明

    • linux：Linux。

    • windows：Windows。

    • 當 Name 返回為 hcStatus 時，枚舉值為：

    說明

    • NO：否。

    • YES：是。

    • 當 Name 返回為 vulStatus 時，枚舉值為：

    說明

    • NO：否。

    • YES：是。

    • 當 Name 返回為 asapVulStatus 時，枚舉值為：

    說明

    • NO：否。

    • YES：是。

    • 當 Name 返回為 alarmStatus 時，枚舉值為：

    說明

    • NO：否。

    • YES：是。

    • 當 Name 返回為 riskStatus 時，枚舉值為：

    說明

    • NO：否。

    • YES：是。

    • UNKNOWN：未知。

    • 當 Name 返回為 clientStatus 時，枚舉值為：

    說明

    • online：線上。

    • offline：離線。

    • pause：暫停防護。

    • 當 Name 返回為 clientSubStatus 時，枚舉值為：

    說明

    • online：線上。

    • offline：離線。

    • pause：暫停防護。

    • stopped：關機。

    • uninstalled：未安裝。

    • 當 Name 返回為 runningStatus 時，枚舉值為：

    說明

    • Running：開機。

    • notRunning：關機。

    • UNKNOWN：未知。

    • 當 Name 返回為 importance 時，枚舉值為：

    說明

    • important：重要。

    • general：一般。

    • test：測試。

    • 當 Name 返回為 containerStatus 時，枚舉值為：

    說明

    • NO：否。

    • YES：是。

    • 當 Name 返回為 exposedStatus 時，枚舉值為：

    說明

    • NO：否。

    • YES：是。

    • 當 Name 返回為 authVersion 時，枚舉值為：

    說明

    • 1：免費版。

    • 3：企業版。

    • 5：進階版。

    • 6：防病毒版。

    • 7：旗艦版。

    • 當 Name 返回為 flag 時，枚舉值為：

    說明

    • 0|8|15：阿里雲。

    • 1：雲外主機。

    • 2：IDC。

    • 3：騰訊雲。

    • 4：華為雲。

    • 5：Azure。

    • 7：AWS。

    • 9：SAE。

    • 10：PAI。

    • 13：ACS。

    • 14：火山雲。

    • 16：Google雲。

    • 當 Name 返回為 aiStatus 時，枚舉值為：

    說明

    • NO：否。

    • YES：是。

    • 當 Name 返回為 ecsType 時，枚舉值為：

    說明

    • 8：Simple Application Server。

    • 11：靈俊。

    • 15：RDS Custom。

    • !8：主機伺服器。

    • 當 Name 返回為 alisecguardStatus 時，枚舉值為：

    說明

    • 0：外掛程式線上。

    • 1：未開啟。

    • 2：外掛程式離線。

    • -99：安裝失敗。

    • 當 Name 返回為 alihipsStatus 時，枚舉值為：

    說明

    • 0：外掛程式線上。

    • 1：未開啟。

    • 2：外掛程式離線。

    • -99：安裝失敗。

    • 當 Name 返回為 alinetStatus 時，枚舉值為：

    說明

    • 0：外掛程式線上。

    • 1：未開啟。

    • 2：外掛程式離線。

    • -99：安裝失敗。

    • 當 Name 返回為 alidetectStatus 時，枚舉值為：

    說明

    • 0：外掛程式線上。

    • 1：未開啟。

    • 2：外掛程式離線。

    • -99：安裝失敗。

    • 當 Name 返回為 yundunMonitorStatus 時，枚舉值為：

    說明

    • 0：外掛程式線上。

    • 1：未開啟。

    • 2：外掛程式離線。

    • -99：安裝失敗。

    • 當 Name 返回為 clusterNodeStatus 時，枚舉值為：

    說明

    • false：否。

    • true：是。

    47.96.XX.XX
    MultiValues

    string

    輸入的模糊比對值對應的資產的具體結構化屬性值。JSON 格式，包含以下欄位：

    • vendor：供應商

    • regionIds：支援地區

    [{"vendor":0,"regionIds":{"default":["ap-southeast-1","ap-northeast-2","ap-southeast-3","ap-southeast-5","ap-southeast-7","me-central-1"]}},{"vendor":1,"regionIds":{"default":["outside-of-aliyun"]}}]

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "8E6DDACF-99AF-5939-AFFD-FCCD3B01E724",
  "CriteriaList": [
    {
      "Type": "input",
      "Name": "internetIp",
      "Values": "47.96.XX.XX",
      "MultiValues": "[{\"vendor\":0,\"regionIds\":{\"default\":[\"ap-southeast-1\",\"ap-northeast-2\",\"ap-southeast-3\",\"ap-southeast-5\",\"ap-southeast-7\",\"me-central-1\"]}},{\"vendor\":1,\"regionIds\":{\"default\":[\"outside-of-aliyun\"]}}]"
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

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

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

    變更歷史

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