全部產品
Search

搜尋本產品

    Security Center：DescribeAgentlessSensitiveFileByKey

    文件中心

    Security Center：DescribeAgentlessSensitiveFileByKey

    更新時間：Jun 15, 2026

    取得無代理檢測功能檢測出的含有某一敏感檔案類型的資產列表。

    介面說明

    僅支援開通雲端安全中心無代理檢測按量付費的阿里雲帳號呼叫該介面。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-sas:DescribeAgentlessSensitiveFileByKey

    get

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    SensitiveFileKey

    string

    否

    敏感檔案類型。

    sshpasswd
    Status

    string

    否

    基線風險的修復狀態。取值：

    • 0：未修復

    • 1：已修復。

    0
    InstanceId

    string

    否

    指定要查詢的資產執行個體 ID，可透過任務管理 - 詳情 - 檢測對象取得。

    i-bp1fu4aqltf1huhc****
    Remark

    string

    否

    資產名稱或 IP。

    1.2.XX.XX
    PageSize

    integer

    否

    指定分頁查詢時，每頁顯示的資料最大筆數。每頁預設顯示的資料筆數為 20 筆，PageSize 參數值為空時，將預設返回 20 筆資料。

    說明

    建議 PageSize 取值不要為空。

    50
    CurrentPage

    integer

    否

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

    1
    ScanRange

    array

    否

    掃描範圍集合。

    string

    否

    單個掃描範圍。取值：

    • agentless_image：主機映像。

    • agentless_snapshot：主機快照。

    • ecs_image：自訂映像。

    • ecs_snapshot：使用者快照。

    agentless_image
    ImageUuid

    string

    否

    指定掃描資產的 UUID，可透過主機資產和雲端產品頁面取得。主機安全檢測場景下，該參數為掃描主機的 UUID。快照安全檢測和自訂映像安全檢測場景下，該參數為掃描映像/快照的 ID。

    06293273b67d19516cfcc712194f****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

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

    FBBEB173-1F43-505F-A876-C03ECDF6CE4C
    PageInfo

    object

    分頁資訊。

    CurrentPage

    integer

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

    1
    PageSize

    integer

    分頁查詢時，每頁顯示的統計資訊的數量。

    20
    TotalCount

    integer

    查詢結果的總數。

    100
    Count

    integer

    分頁查詢時，當前頁顯示的資料總數量。

    20
    SensitiveFileList

    array<object>

    無代理檢測敏感檔案資訊。

    object

    無代理檢測敏感檔案資訊。

    SensitiveFileKey

    string

    敏感檔案類型。

    pem
    RiskLevel

    string

    風險等級。取值：

    • high：高危。

    • medium：中危。

    • low：低危。

    high
    InternetIp

    string

    無代理檢測資產的公網 IP 位址。

    95.214.XX.XX
    IntranetIp

    string

    無代理檢測資產的私網 IP 位址。

    10.68.XX.XX
    Uuid

    string

    無代理檢測資產的 UUID。

    73e6a851-e63b-49ef-9d7a-5542d765****
    TargetName

    string

    無代理檢測掃描對象名稱。

    SAS_Agentless_171869952****
    Status

    integer

    敏感檔案狀態。取值：

    • 0：未處理。

    • 1：忽略。

    • 2：誤報。

    0
    InstanceName

    string

    無代理檢測資產的執行個體名稱。

    test-server
    FirstScanTime

    integer

    首次掃描的時間戳記，單位：毫秒。

    1663321552000
    LastScanTime

    integer

    最新掃描的時間戳記，單位：毫秒。

    1663691592000
    Md5

    string

    敏感檔案的 md5。

    b484b0dff093f358897486b58266****
    FilePath

    string

    敏感檔案路徑。

    /usr/lib/abc.txt
    Prompt

    string

    敏感檔案內容。

    mysql -u -p****
    Id

    integer

    敏感檔案告警 ID。

    423505573
    Success

    boolean

    返回的查詢結果的狀態。取值：

    • true：成功

    • false：失敗。

    true

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "FBBEB173-1F43-505F-A876-C03ECDF6CE4C",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 100,
    "Count": 20
  },
  "SensitiveFileList": [
    {
      "SensitiveFileKey": "pem",
      "RiskLevel": "high",
      "InternetIp": "95.214.XX.XX",
      "IntranetIp": "10.68.XX.XX",
      "Uuid": "73e6a851-e63b-49ef-9d7a-5542d765****",
      "TargetName": "SAS_Agentless_171869952****",
      "Status": 0,
      "InstanceName": "test-server",
      "FirstScanTime": 1663321552000,
      "LastScanTime": 1663691592000,
      "Md5": "b484b0dff093f358897486b58266****",
      "FilePath": "/usr/lib/abc.txt",
      "Prompt": "mysql -u -p****",
      "Id": 423505573
    }
  ],
  "Success": true
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    500 ServerError ServerError
    403 NoPermission caller has no permission

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

    變更歷史

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