全部產品
Search

搜尋本產品

    Cloud Firewall：DescribeAssetList - 查詢Cloud Firewall防護的資產的資訊

    文件中心

    Cloud Firewall：DescribeAssetList - 查詢Cloud Firewall防護的資產的資訊

    更新時間：Nov 12, 2025

    查詢Cloud Firewall防護的資產的資訊。

    介面說明

    本介面一般用於分頁查詢Cloud Firewall防護的資產的資訊。

    QPS 限制

    本介面的單使用者 QPS 限制為 10 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。

    調試

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

    調試

    授權資訊

    當前API暫無授權資訊透出。

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Lang

    string

    否

    接收訊息的語言類型。取值：

    • zh（預設）：中文。

    • en：英文。

    zh
    CurrentPage

    string

    是

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

    1
    PageSize

    string

    是

    分頁查詢時，設定每頁包含Cloud Firewall防護資產的數量。

    10
    RegionNo

    string

    否

    Cloud Firewall所在的地區 ID。

    說明

    關於Cloud Firewall支援地區的詳細資料，請參見支援的地區。

    cn-hangzhou
    Status

    string

    否

    Cloud Firewall狀態。取值：

    • open：保護中。

    • opening：保護開啟中。

    • closed：保護未開啟。

    • closing：保護關閉中。

    說明

    不設定該參數表示查詢所有防火牆狀態。

    open
    SearchItem

    string

    否

    資產的 IP 或者執行個體 ID。

    192.0.XX.XX
    Type

    string

    否

    本參數已廢棄。

    eip
    ResourceType

    string

    否

    資產類型。取值：

    • BastionHostEgressIP：Bastionhost出口 IP。

    • BastionHostIngressIP：Bastionhost入口 IP。

    • EcsEIP：ECS EIP。

    • EcsPublicIP：ECS 公網 IP。

    • EIP：彈性公網 IP。

    • EniEIP：彈性網卡 EIP。

    • NatEIP：NAT EIP。

    • SlbEIP：SLB EIP(CLB EIP)。

    • SlbPublicIP：SLB 公網 IP(CLB 公網 IP)。

    • NatPublicIP：NAT 公網 IP。

    • HAVIP：高可用虛擬 IP。

    EIP
    SgStatus

    string

    否

    安全性群組策略狀態。取值：

    • pass：已下發。

    • block：未下發。

    • unsupport：不支援。

    說明

    不設定該參數表示查詢所有安全性群組策略狀態。

    pass
    IpVersion

    string

    否

    Cloud Firewall防護的資產的 IP 版本。取值：

    • 4（預設）：IPv4。

    • 6：IPv6。

    4
    MemberUid

    integer

    否

    Cloud Firewall成員帳號的 UID。

    258039427902****
    UserType

    string

    否

    使用者類型。取值：

    • buy（預設）：付費使用者。

    • free：免費使用者。

    buy
    NewResourceTag

    string

    否

    資產發現的時間。取值：

    • discovered in 1 hour：資產是 1 小時內新增的。

    • discovered in 1 day：資產是 1 天內新增的。

    • discovered in 7 days：資產是 7 天內新增的。

    discovered in 1 hour
    OutStatistic

    string

    否

    是否查詢外聯流量資訊。

    true
    SensitiveStatus

    string

    否

    資料泄漏檢測開啟狀態。

    open

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    TotalCount

    integer

    Cloud Firewall防護的資產總數量。

    12
    RequestId

    string

    結果的請求 ID。

    CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D
    Assets

    array<object>

    Cloud Firewall防護的資產資訊。

    object

    RiskLevel

    string

    資產的風險層級。取值：

    • low：低風險。

    • middle：中風險。

    • hight：高風險。

    說明

    僅當 UserType 的值為 free 時，才會返回該參數。

    low
    BindInstanceName

    string

    綁定資產執行個體名稱。

    instance01
    Type

    string

    該參數已廢棄。

    eip
    SgStatusTime

    integer

    最近一次安全性群組狀態檢測時間，使用時間戳格式。單位：秒。

    1615082937
    ResourceInstanceId

    string

    資產執行個體 ID。

    i-8vbdrjrxzt78****
    MemberUid

    integer

    Cloud Firewall成員帳號的 UID。

    258039427902****
    IntranetAddress

    string

    伺服器內網 IP。

    192.168.XX.XX
    SyncStatus

    string

    資產引流支援狀態。取值：

    • enable：支援引流。

    • disable：不支援引流。

    enable
    AliUid

    integer

    阿里雲帳號的 UID。

    說明

    Cloud Firewall成員帳號的主帳號。

    158039427902****
    ProtectStatus

    string

    防火牆狀態。取值：

    • open：保護中。

    • opening：保護開啟中。

    • closed：未受保護。

    • closing：保護關閉中。

    open
    InternetAddress

    string

    伺服器公網 IP。

    192.0.XX.XX
    BindInstanceId

    string

    綁定資產執行個體 ID。

    i-8vbdrjrxzt78****
    RegionID

    string

    資產所在的地區 ID。

    cn-hangzhou
    RegionStatus

    string

    資產所在地區是否支援開啟Cloud Firewall防護狀態。取值：

    • enable：支援。

    • disable：不支援。

    enable
    ResourceType

    string

    資產類型。取值：

    • BastionHostEgressIP：Bastionhost出口 IP。

    • BastionHostIngressIP：Bastionhost入口 IP。

    • EcsEIP：ECS EIP。

    • EcsPublicIP：ECS 公網 IP。

    • EIP：彈性公網 IP。

    • EniEIP：彈性網卡 EIP。

    • NatEIP：NAT EIP。

    • SlbEIP：SLB EIP。

    • SlbPublicIP：SLB 公網 IP。

    • NatPublicIP：NAT 公網 IP。

    • HAVIP：高可用虛擬 IP。

    EIP
    IpVersion

    integer

    Cloud Firewall防護的資產的 IP 位址版本。

    取值：

    • 4：表示 IPv4 地址。

    • 6：表示 IPv6 地址。

    4
    SgStatus

    string

    安全性群組策略。取值：

    • pass：已下發。

    • block：未下發。

    • unsupport：不支援。

    block
    Note

    string

    資產的備忘資訊。取值：

    • REGION_NOT_SUPPORT：地區不支援。

    • NETWORK_NOT_SUPPORT：網路不支援。

    REGION_NOT_SUPPORT
    Name

    string

    Cloud Firewall防護的資產的執行個體名稱。

    instance01
    CreateTimeStamp

    string

    Cloud Firewall發現資產的時間。

    2023-02-28 10:29:58
    NewResourceTag

    string

    資產發現的時間。取值：

    • discovered in 1 hour：資產是 1 小時內新增的。

    • discovered in 1 day：資產是 1 天內新增的。

    • discovered in 7 days：資產是 7 天內新增的。

    discovered in 1 hour
    SensitiveDataStatus

    string

    資料泄漏檢測開啟狀態。

    open
    Last7DayOutTrafficBytes

    integer

    近 7 日外聯流量。

    0

    樣本

    正常返回樣本

    JSON格式

    {
  "TotalCount": 12,
  "RequestId": "CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D",
  "Assets": [
    {
      "RiskLevel": "low",
      "BindInstanceName": "instance01",
      "Type": "eip",
      "SgStatusTime": 1615082937,
      "ResourceInstanceId": "i-8vbdrjrxzt78****",
      "MemberUid": 0,
      "IntranetAddress": "192.168.XX.XX",
      "SyncStatus": "enable",
      "AliUid": 0,
      "ProtectStatus": "open",
      "InternetAddress": "192.0.XX.XX",
      "BindInstanceId": "i-8vbdrjrxzt78****",
      "RegionID": "cn-hangzhou",
      "RegionStatus": "enable",
      "ResourceType": "EIP",
      "IpVersion": 4,
      "SgStatus": "block",
      "Note": "REGION_NOT_SUPPORT",
      "Name": "instance01",
      "CreateTimeStamp": "2023-02-28 10:29:58",
      "NewResourceTag": "discovered in 1 hour",
      "SensitiveDataStatus": "open",
      "Last7DayOutTrafficBytes": 0
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 ErrorDBSelect An error occurred while querying database. 內部錯誤：資料庫查詢錯誤

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

    變更歷史

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