全部產品
Search

搜尋本產品

    Security Center：ListVirusScanTask

    文件中心

    Security Center：ListVirusScanTask

    更新時間：Jun 16, 2026

    根據任務的掃描類型、掃描狀態和檢測的機器資訊等查詢符合條件的病毒掃描任務。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-sas:ListVirusScanTask

    get

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    TaskId

    string

    否

    指定要查詢的病毒掃描任務 ID。

    說明

    您可以呼叫 ListVirusScanTask 介面取得該參數。

    1471d8ebb96795b41ede090b9758****
    ScanType

    string

    否

    指定待查詢病毒掃描任務的掃描類型。 取值：

    • system：系統自動掃描

    • user：系統自訂掃描。

    user
    Status

    integer

    否

    病毒掃描任務的執行的狀態。 取值：

    • 1：檢測中

    • 2：完成

    • 3：失敗

    • 4：逾時。

    1
    StartTime

    integer

    否

    查詢的任務開始時間的時間戳記（毫秒）。

    1680919232000
    EndTime

    integer

    否

    查詢的任務結束時間的時間戳記（毫秒）。

    1680919232999
    RootTask

    boolean

    否

    查詢的任務是否是病毒掃描的主任務。

    true
    RootTaskId

    string

    否

    根任務 ID。

    說明

    您可以呼叫 GetVirusScanLatestTaskStatistic 介面取得該參數。

    89f5d7813bd59dd237580a8664b3xxxx
    MachineName

    string

    否

    伺服器的名稱。

    oracle-win-001****
    InternetIp

    string

    否

    公網 IP。

    120.27.XX.XX
    IntranetIp

    string

    否

    內網 IP。

    172.26.XX.XX
    CurrentPage

    integer

    否

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

    1
    PageSize

    integer

    否

    設定分頁查詢時，每頁包含的任務的數量。預設值為 20，表示每頁包含 20 個任務。

    20
    StatusList

    array

    否

    多個狀態篩選填寫的狀態列表。

    integer

    否

    病毒掃描任務的執行的狀態。 取值：

    • 1：檢測中

    • 2：完成

    • 3：失敗

    • 4：逾時。

    1
    Lang

    string

    否

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

    • zh：中文

    • en：英文。

    zh

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回的訊息體。

    RequestId

    string

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

    A4EB8B1C-1DEC-5E18-BCD0-D1BBB3936FA7
    PageInfo

    object

    分頁資訊。

    CurrentPage

    integer

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

    1
    PageSize

    integer

    分頁查詢時，每頁最多顯示的資料條數。

    20
    TotalCount

    integer

    查詢到的資料總條數。

    224
    List

    array<object>

    結果列表。

    object

    列表中包含的資料體。

    TaskId

    string

    檢查任務的 ID。

    2e75557bfa570381f5c516cad9b6xxxx
    ScanType

    string

    病毒掃描的任務掃描類型。 取值：

    • system：系統自動掃描

    • user：使用者自訂掃描。

    system
    Status

    integer

    病毒掃描任務的執行的狀態。 取值：

    • 1：檢測中

    • 2：完成

    • 3：失敗

    • 4：逾時。

    1
    StartTime

    integer

    開始時間戳記（毫秒）。

    1651290987000
    EndTime

    integer

    結束時間戳記（毫秒）。

    1662343860051
    InstanceName

    string

    伺服器執行個體名稱。

    sql-test-0****
    InternetIp

    string

    伺服器的公網 IP。

    8.210.XX.XX
    IntranetIp

    string

    伺服器的私網 IP。

    172.25.XX.XX
    TaskName

    string

    任務名稱。

    • VIRUS_VUL_SCHEDULE_SCAN：病毒掃描。

    VIRUS_VUL_SCHEDULE_SCAN
    Progress

    integer

    任務進度百分比。

    62
    ScanPath

    array

    掃描的檔案資訊。

    string

    檔案路徑。

    C:/test1
    Uuid

    string

    伺服器的 UUID。

    49e25e0f-bb51-4a5a-a1b3-13a4ddaa****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "A4EB8B1C-1DEC-5E18-BCD0-D1BBB3936FA7",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 224
  },
  "List": [
    {
      "TaskId": "2e75557bfa570381f5c516cad9b6xxxx",
      "ScanType": "system",
      "Status": 1,
      "StartTime": 1651290987000,
      "EndTime": 1662343860051,
      "InstanceName": "sql-test-0****",
      "InternetIp": "8.210.XX.XX",
      "IntranetIp": "172.25.XX.XX",
      "TaskName": "VIRUS_VUL_SCHEDULE_SCAN",
      "Progress": 62,
      "ScanPath": [
        "C:/test1"
      ],
      "Uuid": "49e25e0f-bb51-4a5a-a1b3-13a4ddaa****"
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    500 ServerError ServerError
    403 NoPermission caller has no permission

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

    變更歷史

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