全部產品
Search

搜尋本產品

    Cloud Firewall：DescribeAssetList

    文件中心

    Cloud Firewall：DescribeAssetList

    更新時間：Jun 18, 2026

    查詢雲端防火牆防護的資產的資訊。

    介面說明

    本介面一般用於分頁查詢雲端防火牆防護的資產的資訊。

    QPS 限制

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

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-cloudfirewall:DescribeAssetList

    get

    *Asset

    acs:cloudfirewall::{#accountId}:asset/{#Type}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Lang

    string

    否

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

    • zh（預設）：中文。

    • en：英文。

    zh
    CurrentPage

    string

    是

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

    1
    PageSize

    string

    是

    分頁查詢時，設定每頁包含雲端防火牆防護資產的數量。

    10
    RegionNo

    string

    否

    雲端防火牆所在的地域 ID。

    說明

    關於雲端防火牆支援地域的詳細資訊，請參見支援的地域。

    cn-hangzhou
    Status

    string

    否

    雲端防火牆狀態。取值：

    • open：保護中。

    • opening：保護開啟中。

    • closed：保護未開啟。

    • closing：保護關閉中。

    說明

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

    open
    SearchItem

    string

    否

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

    192.0.XX.XX
    Type deprecated

    string

    否

    本參數已廢棄。

    eip
    ResourceType

    string

    否

    資產類型。取值：

    • BastionHostEgressIP：堡壘機出口 IP。

    • BastionHostIngressIP：堡壘機入口 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。

    • NlbEIP：NLB EIP。

    • ApiGatewayEIP：API 閘道公網 IP。

    • AlbEIP：ALB EIP。

    • AiGatewayEIP：AI 閘道公網 IP。

    • GaEIP：GA EIP。

    • SwasEIP：輕量應用伺服器公網 IP。

    • EcdEIP：無影公網 IP。

    • BastionHostIP：堡壘機 IP。

    EIP
    SgStatus

    string

    否

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

    • pass：已下發。

    • block：未下發。

    • unsupport：不支援。

    說明

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

    pass
    IpVersion

    string

    否

    雲端防火牆防護的資產的 IP 版本。取值：

    • 4（預設）：IPv4。

    • 6：IPv6。

    4
    MemberUid

    integer

    否

    雲端防火牆成員帳號的 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

    雲端防火牆防護的資產總數量。

    12
    RequestId

    string

    結果的請求 ID。

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

    array<object>

    雲端防火牆防護的資產資訊。

    object

    RiskLevel

    string

    資產的風險級別。取值：

    • low：低風險。

    • middle：中風險。

    • hight：高風險。

    說明

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

    low
    BindInstanceName

    string

    繫結資產執行個體名稱。

    instance01
    Type deprecated

    string

    該參數已廢棄。

    eip
    SgStatusTime

    integer

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

    1615082937
    ResourceInstanceId

    string

    資產執行個體 ID。

    i-8vbdrjrxzt78****
    MemberUid

    integer

    雲端防火牆成員帳號的 UID。

    258039427902****
    IntranetAddress

    string

    伺服器內網 IP。

    192.168.XX.XX
    SyncStatus

    string

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

    • enable：支援引流。

    • disable：不支援引流。

    enable
    AliUid

    integer

    阿里雲帳號的 UID。

    說明

    雲端防火牆成員帳號的主帳號。

    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

    資產所在地域是否支援開啟雲端防火牆防護狀態。取值：

    • enable：支援。

    • disable：不支援。

    enable
    ResourceType

    string

    資產類型。取值：

    • BastionHostEgressIP：堡壘機出口 IP。

    • BastionHostIngressIP：堡壘機入口 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。

    • NlbEIP：NLB EIP。

    • ApiGatewayEIP：API 閘道公網 IP。

    • AlbEIP：ALB EIP。

    • AiGatewayEIP：AI 閘道公網 IP。

    • GaEIP：GA EIP。

    • SwasEIP：輕量應用伺服器公網 IP。

    • EcdEIP：無影公網 IP。

    • BastionHostIP：堡壘機 IP。

    EIP
    IpVersion

    integer

    雲端防火牆防護的資產的 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

    雲端防火牆防護的資產的執行個體名稱。

    instance01
    CreateTimeStamp

    string

    雲端防火牆發現資產的時間。時間格式為 YYYY-MM-DD HH:mm:ss。

    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.

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

    變更歷史

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