使用DescribeGroupedMaliciousFiles查詢鏡像惡意樣本檔案-Security Center-阿里雲 - Security Center

查詢映像惡意樣本檔案列表。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-sas:DescribeGroupedMaliciousFiles

get

*All Resource

*

無

請求參數

名稱	類型	必填	描述	樣本值
Lang	string	否	請求和接收訊息的語言類型，預設為 zh。取值： zh：中文 en：英文。	zh
Levels	string	否	要查詢的映像惡意樣本的危險程度。可輸入多個值，多個值之間使用英文逗號（,）分隔。取值： serious：緊急 suspicious：可疑 remind：提醒。	serious
FuzzyMaliciousName	string	否	要查詢的惡意檔案名稱。說明支援模糊搜尋。	Mining
CurrentPage	integer	是	從返回結果中的第幾頁開始顯示。起始值為 1。預設值為 1，表示從第 1 頁開始顯示。	1
PageSize	string	是	分頁查詢時，每頁顯示的資料的最大條數。預設值為 20。	20
RepoRegionId	string	否	映像倉庫的地域 ID。取值： cn-beijing：華北 2（北京） cn-zhangjiakou：華北 3（張家口） cn-hangzhou：華東 1（杭州） cn-shanghai：華東 2（上海） cn-shenzhen：華南 1（深圳） cn-hongkong：中國香港 ap-southeast-1：新加坡 ap-southeast-5：印度尼西亞（雅加達） us-east-1：美國（維吉尼亞） us-west-1：美國（矽谷） eu-central-1：德國（法蘭克福） eu-west-1：英國（倫敦）。	cn-shanghai
RepoInstanceId	string	否	容器映像的執行個體 ID。說明呼叫容器映像服務的 ListRepository 介面，透過返回參數 InstanceId 的值可以取得容器映像執行個體 ID。	cri-datvailb****
RepoId	string	否	映像倉庫 ID。說明呼叫容器映像服務的 ListRepository 介面，透過返回參數 RepoId 的值可以取得映像倉庫 ID。	crr-vridcl4****
RepoName	string	否	映像倉庫名稱。說明支援模糊搜尋。	centos
RepoNamespace	string	否	映像倉庫命名空間名稱。說明支援模糊查詢。	hanghai-namespace
ImageTag	string	否	映像標籤。	0.2
ImageDigest	string	否	映像摘要。	6a5e103187b31a94592a47a5858617f7****
ImageLayer	string	否	映像的層。	27213ad375b53628dd152a5ca****
ClusterId	string	否	需要查詢異常事件的伺服器的叢集 ID。	c556c8133b5ad4378b7fc533ddbda****
ScanRange	array	否	掃描範圍集合。
	string	否	掃描範圍。取值： container：容器 image：映像。	container
MaliciousMd5	string	否	惡意檔案的 md5 值。	d836968041f7683b5459****

返回參數

名稱	類型	描述	樣本值
	object	請求返回參數。
RequestId	string	本次呼叫請求的 ID，是由阿里雲為該請求生成的唯一識別碼，可用於排查和定位問題。	8045E03E-6D91-4C53-9F22-5A1B84BB29D9
PageInfo	object	分頁資訊。
CurrentPage	integer	分頁查詢時，當前頁的頁碼。	1
PageSize	integer	分頁查詢時，每頁顯示的資料的最大條數。預設值為 20。	20
TotalCount	integer	惡意樣本檔案的總數。	2
Count	integer	當前頁返回的惡意樣本檔案的數量。	2
GroupedMaliciousFileResponse	array<object>	惡意樣本檔案列表。
	object	映像惡意樣本檔案資訊。
Status	integer	映像惡意樣本的處理狀態。取值： 0：未處理 1：已處理 2：驗證中 3：已加白。	0
ImageCount	integer	被惡意樣本影響的映像數量。	3
LatestScanTimestamp	integer	最新掃描時間戳記，單位：毫秒。	1596533942000
MaliciousName	string	惡意檔案的名稱。	testFile
MaliciousMd5	string	惡意檔案的 MD5 值。	d836968041f7683b5459****
FirstScanTimestamp	integer	首次掃描時間戳記，單位：毫秒。	1594907349000
Level	string	映像惡意樣本的危險程度。取值： serious：緊急 suspicious：可疑 remind：提醒。	serious
MaliciousKey	string	惡意檔案的關鍵字。	WEBSHELL_IMG

樣本

正常返回樣本

JSON格式

{
  "RequestId": "8045E03E-6D91-4C53-9F22-5A1B84BB29D9",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 2,
    "Count": 2
  },
  "GroupedMaliciousFileResponse": [
    {
      "Status": 0,
      "ImageCount": 3,
      "LatestScanTimestamp": 1596533942000,
      "MaliciousName": "testFile",
      "MaliciousMd5": "d836968041f7683b5459****",
      "FirstScanTimestamp": 1594907349000,
      "Level": "serious",
      "MaliciousKey": "WEBSHELL_IMG"
    }
  ]
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
500	ServerError	ServerError
403	NoPermission	caller has no permission

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

變更歷史

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