全部產品
Search

搜尋本產品

    Security Center：DescribeHybridProxyList

    文件中心

    Security Center：DescribeHybridProxyList

    更新時間：Jun 16, 2026

    透過該介面，可以分頁查詢到指定代理叢集已經部署的代理節點列表。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-sas:DescribeHybridProxyList

    get

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ClusterName

    string

    否

    代理叢集名稱。

    idc-sas-proxy
    CurrentPage

    integer

    否

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

    1
    PageSize

    integer

    否

    分頁查詢時，顯示的每頁資料的最大條數。預設值為 20。

    20

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    PageInfo

    object

    頁面顯示的資訊。

    CurrentPage

    integer

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

    1
    PageSize

    integer

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

    20
    TotalCount

    integer

    查詢到的結果的總條數。

    69
    Count

    integer

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

    20
    ProxyList

    array<object>

    代理叢集列表資訊。

    object

    InstanceId

    string

    資產的執行個體 ID。

    i-uf61q03boqhhmeai1XXX
    InstanceName

    string

    資產執行個體名稱。

    dev
    InternetIp

    string

    伺服器的公網 IP 位址。

    47.76.XXX.XXX
    IntranetIp

    string

    伺服器的私網 IP 位址。

    172.23.XXX.XXX
    Status

    string

    當前代理機器運行的狀態。取值：

    • online：線上

    • offline：離線。

    online
    Uuid

    string

    當前代理執行個體部署的雲端安全中心用戶端的 UUID。

    59a9d158-b2f0-4766-a893-ae67b9432721
    ClientCount

    integer

    連接到當前代理執行個體的雲端安全中心用戶端數量。

    10
    ProxyUuid

    string

    標識當前代理節點唯一的 KEY。

    inet-proxy-3bb11fad-37d6-4aee-9c37-b0ad1612a18e
    CurrentVersion

    string

    當前代理執行個體的版本資訊。

    proxy_01_05
    RequestId

    string

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

    75801E5D-E2EB-5C1D-B65D-2F7D2B00EF93

    樣本

    正常返回樣本

    JSON格式

    {
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 69,
    "Count": 20
  },
  "ProxyList": [
    {
      "InstanceId": "i-uf61q03boqhhmeai1XXX",
      "InstanceName": "dev",
      "InternetIp": "47.76.XXX.XXX",
      "IntranetIp": "172.23.XXX.XXX",
      "Status": "online",
      "Uuid": "59a9d158-b2f0-4766-a893-ae67b9432721",
      "ClientCount": 10,
      "ProxyUuid": "inet-proxy-3bb11fad-37d6-4aee-9c37-b0ad1612a18e",
      "CurrentVersion": "proxy_01_05"
    }
  ],
  "RequestId": "75801E5D-E2EB-5C1D-B65D-2F7D2B00EF93"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 IllegalParam Illegal param
    500 ServerError ServerError
    403 NoPermission caller has no permission

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

    變更歷史

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