全部產品
Search
文件中心

Security Center:ListObjectScanEvent

更新時間:Jun 15, 2026

查詢惡意檔案告警列表。

調試

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

調試

授權資訊

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

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

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-sas:ListObjectScanEvent

get

*All Resource

*

請求參數

名稱

類型

必填

描述

樣本值

CurrentPage

integer

分頁查詢時,顯示的當前頁的頁碼。

1

PageSize

integer

指定分頁查詢時,每頁顯示的資料最大條數。

20

RiskLevel

string

風險等級。取值:

  • high:高危

  • medium:中危

  • low:低危。

low

EventName

string

告警名稱。

WebShell

Source

string

資料來源。取值:

  • API:API 檢測

  • OSS:OSS 檢測。

OSS

OssKey

string

檔案在 OSS Bucket 中的儲存 Key。

1/2022/06/23/15/41/16559701077444693a0c6-33b2-4cc2-a99f-9f38b8b8****

BucketName

string

Bucket 名稱。

ltrbuck****

Lang

string

請求和接收訊息的語言類型,預設值為 zh。取值:

  • zh:中文

  • en:英文。

zh

Md5

string

檔案 MD5 值。

0552c44e243abdea1729d4507bce****

TimeStart

integer

異常事件發生時間的開始時間。

1683603086000

TimeEnd

integer

異常事件發生時間的結束時間。

1683862286000

ParentEventId

integer

檔案為壓縮包子檔案時,ParentEventId 表示所在壓縮包本身告警的事件 ID。

取得並查詢壓縮包子檔案告警事件流程:

  1. 先呼叫本介面查看返回參數 HasSubEvent,如果值為 true,對應 EventId 即是壓縮包本身告警的事件 ID。

  2. 再次呼叫本介面將 EventId 值傳入 ParentEventId,即可查看該壓縮包子檔案的告警事件。

1

Status

integer

事件狀態。取值如下:

  • 0: 未處理

  • 1: 我已手動處理

  • 2: 已加白

  • 3: 已忽略

  • 4: 禁止存取。

0

EventId

integer

事件 ID。

8925****

BatchType

string

批次操作類型。取值:

  • sha256:相同檔案內容

  • eventName:相同告警類型。

sha256

返回參數

名稱

類型

描述

樣本值

object

詳情資料。

RequestId

string

本次呼叫請求的 ID,是由阿里雲為該請求生成的唯一標識符,可用於排查和定位問題。

7BC55C8F-226E-5AF5-9A2C-2EC43864****

PageInfo

object

分頁查詢時的頁面資訊。

CurrentPage

integer

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

1

PageSize

integer

分頁查詢時,顯示的每頁資料的最大條數。

20

TotalCount

integer

總條數。

253

Data

array<object>

資料詳情。

array<object>

資料詳情。

OssKey

string

檔案在 OSS Bucket 中的儲存 Key。

1/2023/07/21/10/18/16899059356518bcf6c64-a04e-492d-a421-4ae8b888****

Md5

string

檔案 MD5 值。

5b394b54ca632fe51c4ab4a6dbaf****

BucketName

string

Bucket 名稱。

hz-new01****

RiskLevel

string

掃描出的告警的風險等級。取值:

  • high:高危。

  • medium:中危。

  • low:低危。

medium

Source

string

資料來源。取值:

  • API:API 檢測

  • OSS:OSS 檢測。

OSS

FilePath

string

檔案路徑。

/usr/local****

EventName

string

告警項名稱。

WebShell

EventId

integer

事件 ID。

911273

FirstTime

integer

首次發生時間戳。

1694576692000

LastTime

integer

最新發現時間戳。

1694576692000

Sha256

string

檔案 Sha256 值。

3a6fed5fc11392b3ee9f81caf017b48640d7458766a8eb0382899a605b41****

Sha1

string

檔案 Sha1 值。

3c01bdbb26f358bab27f267924aa2c9a03fc****

DisplaySandboxResult

string

支援雲端沙箱檢出。取值包括:

  • true:支援。

  • false:不支援。

true

Details

array<object>

檢查項的詳細資訊。

object

詳情。

Name

string

詳情項名稱。

DownloadUrl

NameDisplay

string

警示事件顯示名稱。

DownloadUrl

Type

string

詳情資訊類型。

html

Value

string

詳情項的值。

http://gcx.cn-hangzhou.aliyuncs.com/****

ValueDisplay

string

詳情項展示的值。

http://gcx.cn-hangzhou.aliyuncs.com/****

HasSubEvent

boolean

是否存在壓縮包子檔案告警,取值為:

  • true:是。您可查看對應 EventId 值,再次呼叫本介面,將 EventId 值傳入 ParentEventId,即可查看對應壓縮包子檔案的告警事件。

  • false:否。

true

Status

integer

事件狀態。取值如下:

  • 0: 未處理

  • 1: 我已手動處理

  • 2: 已加白

  • 3: 已忽略

  • 4: 禁止存取。

0

ErrorMsg

string

錯誤資訊。

connect timed out

OperateResult

string

告警處理結果。

fail

MatchedWhiteListRuleI18nStr

string

加白規則命中資訊。

 &nbspmd5   contains  &nbsp23  

Remark

string

備註。

test

樣本

正常返回樣本

JSON格式

{
  "RequestId": "7BC55C8F-226E-5AF5-9A2C-2EC43864****",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 253
  },
  "Data": [
    {
      "OssKey": "1/2023/07/21/10/18/16899059356518bcf6c64-a04e-492d-a421-4ae8b888****",
      "Md5": "5b394b54ca632fe51c4ab4a6dbaf****",
      "BucketName": "hz-new01****",
      "RiskLevel": "medium",
      "Source": "OSS",
      "FilePath": "/usr/local****",
      "EventName": "WebShell",
      "EventId": 911273,
      "FirstTime": 1694576692000,
      "LastTime": 1694576692000,
      "Sha256": "3a6fed5fc11392b3ee9f81caf017b48640d7458766a8eb0382899a605b41****",
      "Sha1": "3c01bdbb26f358bab27f267924aa2c9a03fc****",
      "DisplaySandboxResult": "true",
      "Details": [
        {
          "Name": "DownloadUrl",
          "NameDisplay": "DownloadUrl",
          "Type": "html",
          "Value": "http://gcx.cn-hangzhou.aliyuncs.com/****",
          "ValueDisplay": "http://gcx.cn-hangzhou.aliyuncs.com/****"
        }
      ],
      "HasSubEvent": true,
      "Status": 0,
      "ErrorMsg": "connect timed out",
      "OperateResult": "fail",
      "MatchedWhiteListRuleI18nStr": " &nbspmd5   contains  &nbsp23  ",
      "Remark": "test"
    }
  ]
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

500 ServerError ServerError
403 NoPermission caller has no permission

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

變更歷史

更多資訊,參考變更詳情