全部產品
Search

搜尋本產品

    Security Center：DescribeWhiteListEffectiveAssets - 查詢策略生效伺服器

    文件中心

    Security Center：DescribeWhiteListEffectiveAssets - 查詢策略生效伺服器

    更新時間：Mar 21, 2026

    查詢應用白名單策略生效的伺服器。

    介面說明

    應用白名單為公測功能，目前已不再支援申請該功能。已申請或正在使用中的使用者可以正常調用該介面。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-sas:DescribeWhiteListEffectiveAssets

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    SourceIp

    string

    否

    請求源 IP。無需填寫，系統自動擷取。

    27.212.XX.XX
    Lang

    string

    否

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

    • zh：中文

    • en：英文

    zh
    Remark

    string

    否

    資產檢索項。可填寫資產的 IP、公網 IP、內網 IP、資產名稱進行模糊比對。

    222.185.XX.XX
    StrategyId

    integer

    否

    策略編號。

    說明

    調用 DescribeWhiteListStrategyList 介面可以擷取該參數。

    8437592
    NeedStatistics

    integer

    否

    是否需要返回資產不可信程式異常啟動的異常行為數量。取值：

    • 0：否

    • 1：是

    0
    PageSize

    integer

    否

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

    說明

    建議 PageSize 取值不要為空白。

    20
    CurrentPage

    integer

    否

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

    1

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    請求返回資料。

    CurrentPage

    integer

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

    1
    PageSize

    integer

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

    20
    RequestId

    string

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

    A4EB8B1C-1DEC-5E18-BCD0-D1BBB39****
    TotalCount

    integer

    生效的伺服器總數。

    100
    Count

    integer

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

    10
    Assets

    array<object>

    生效的伺服器資訊列表。

    object

    生效的伺服器資訊。

    Uuid

    string

    伺服器 UUID。

    544900ff-1be7-4655-9719-6311cecb3****
    StrategyId

    integer

    策略 ID。

    35815387
    StrategyName

    string

    策略名稱稱。

    test
    InternetIp

    string

    伺服器的公網 IP。

    60.205.XX.XX
    SuspiciousEventCount

    integer

    伺服器存在的不可信程式異常啟動的異常行為數量。

    5
    ProcessMethod

    integer

    異常處理模式。取值：

    • 0：不處理

    • 1：警示

    • 2：阻斷

    1
    MachineName

    string

    伺服器名稱。

    test
    IntranetIp

    string

    私網 IP 位址。

    192.168.XX.XX

    樣本

    正常返回樣本

    JSON格式

    {
  "CurrentPage": 1,
  "PageSize": 20,
  "RequestId": "A4EB8B1C-1DEC-5E18-BCD0-D1BBB39****",
  "TotalCount": 100,
  "Count": 10,
  "Assets": [
    {
      "Uuid": "544900ff-1be7-4655-9719-6311cecb3****",
      "StrategyId": 35815387,
      "StrategyName": "test",
      "InternetIp": "60.205.XX.XX",
      "SuspiciousEventCount": 5,
      "ProcessMethod": 1,
      "MachineName": "test",
      "IntranetIp": "192.168.XX.XX"
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

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

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

    變更歷史

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