全部產品
Search

搜尋本產品

    ENS：DescribeNetworkAcls - 查看網路ACL的列表資訊

    文件中心

    ENS：DescribeNetworkAcls - 查看網路ACL的列表資訊

    更新時間：Mar 20, 2026

    調用DescribeNetworkAcls介面查詢已建立的網路ACL。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ens:DescribeNetworkAcls

    list

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    NetworkAclId

    string

    否

    網路 ACL 的 ID。

    nacl-bp1lhl0taikrbgnh****
    NetworkAclName

    string

    否

    網路 ACL 的名稱。

    acl-1
    ResourceId

    string

    否

    關聯執行個體的 ID。

    n-5****
    PageNumber

    string

    否

    安全性群組列表的頁碼。起始值：1。預設值：1。

    1
    PageSize

    string

    否

    分頁查詢時每頁的行數。最大值：50。預設值：10。

    10

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID。

    A1707FC0-430C-423A-B624-284046B20399
    TotalCount

    string

    列表資料總數。

    3
    PageSize

    string

    當前查詢每頁的行數。

    2
    PageNumber

    string

    當前查詢頁碼。

    1
    NetworkAcls

    array<object>

    網路 ACL 的詳細資料。

    array<object>

    Status

    string

    網路 ACL 的狀態。取值：

    • Available：可用。

    • Modifying：配置中。

    Available
    CreationTime

    string

    網路 ACL 的建立時間，使用 UTC 時間格式，格式為yyyy-MM-ddTHH:mm:ssZ。

    2019-11-01T06:08:46Z
    Description

    string

    網路 ACL 的描述資訊。

    This is my NetworkAcl.
    NetworkAclId

    string

    網路 ACL 的 ID。

    nacl-a2do9e413e0spxscd****
    NetworkAclName

    string

    網路 ACL 的名稱。

    acl-8
    IngressAclEntries

    array<object>

    入方向規則資訊。

    object

    Policy

    string

    授權策略，取值：

    • accept：允許。

    • drop：拒絕。

    accept
    NetworkAclEntryId

    string

    入方向規則條目的 ID。

    nae-5dk86arlydmezasw****
    NetworkAclEntryName

    string

    入方向規則條目的名稱。

    acl-3
    CidrBlock

    string

    源位址區段。

    10.0.0.0/24
    Protocol

    string

    協議類型，取值：

    • icmp：網路控制報文協議。

    • tcp：傳輸控制通訊協定。

    • udp：使用者資料包通訊協定。

    • all：支援所有協議。

    all
    PortRange

    string

    入方向規則的目的連接埠範圍。

    • 當入方向規則的 Protocol（協議類型）為 all 或 icmp 時，連接埠範圍為 -1/-1，表示不限制連接埠。

    • 當入方向規則的 Protocol（協議類型）為 tcp 或 udp 時，連接埠範圍為1~65535，格式為1/200或80/80，表示連接埠 1 到連接埠 200 或連接埠 80。

    -1/-1
    Priority

    integer

    規則優先順序。取值範圍：1~100。預設值：1。

    1
    Type

    string

    規則類型。取值：

    • system：系統建立

    • custom：使用者建立

    system
    Description

    string

    入方向規則的描述資訊。

    This is IngressAclEntries.
    DestinationCidrBlock

    string

    目標地址的網路。

    10.0.0.0/24
    EgressAclEntries

    array<object>

    出方向規則資訊。

    object

    Policy

    string

    授權策略，取值：

    • accept：允許。

    • drop：拒絕。

    accept
    NetworkAclEntryId

    string

    出方向規則條目的 ID。

    nae-a2d447uw4tillfvgb****
    NetworkAclEntryName

    string

    出方向規則條目的名稱。

    acl-2
    CidrBlock

    string

    目標位址區段。

    10.0.0.0/24
    Protocol

    string

    協議類型，取值：

    • icmp：網路控制報文協議。

    • tcp：傳輸控制通訊協定。

    • udp：使用者資料包通訊協定。

    • all：支援所有協議。

    all
    PortRange

    string

    出方向規則的目的連接埠範圍。

    • 當出方向規則的 Protocol（協議類型）為 all 或 icmp 時，連接埠範圍為 -1/-1，表示不限制連接埠。

    • 當出方向規則的 Protocol（協議類型）為 tcp 或 udp 時，連接埠範圍為1~65535，格式為1/200或80/80，表示連接埠 1 到連接埠 200 或連接埠 80。

    -1/-1
    Priority

    integer

    規則優先順序。取值範圍：1~100。預設值：1。

    1
    Type

    string

    規則類型。取值：

    • system：系統建立

    • custom：使用者建立

    system
    Description

    string

    出方向規則的描述資訊。

    This is EgressAclEntries.
    Resources

    array<object>

    關聯的資源集合。

    object

    Status

    string

    關聯資源的狀態。取值：

    • BINDED：已綁定。

    • BINDING：綁定中。

    • UNBINDING：解除綁定中。

    BINDING
    ResourceType

    string

    關聯資源的類型。

    Network
    ResourceId

    string

    關聯資源的 ID。

    n-****
    EnsRegionId

    string

    ENS 節點 ID。

    cn-fuzhou-telecom

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "A1707FC0-430C-423A-B624-284046B20399",
  "TotalCount": "3",
  "PageSize": "2",
  "PageNumber": "1",
  "NetworkAcls": [
    {
      "Status": "Available",
      "CreationTime": "2019-11-01T06:08:46Z",
      "Description": "This is my NetworkAcl.",
      "NetworkAclId": "nacl-a2do9e413e0spxscd****",
      "NetworkAclName": "acl-8",
      "IngressAclEntries": [
        {
          "Policy": "accept",
          "NetworkAclEntryId": "nae-5dk86arlydmezasw****",
          "NetworkAclEntryName": "acl-3",
          "CidrBlock": "10.0.0.0/24",
          "Protocol": "all",
          "PortRange": "-1/-1",
          "Priority": 1,
          "Type": "system",
          "Description": "This is IngressAclEntries.",
          "DestinationCidrBlock": "10.0.0.0/24"
        }
      ],
      "EgressAclEntries": [
        {
          "Policy": "accept",
          "NetworkAclEntryId": "nae-a2d447uw4tillfvgb****",
          "NetworkAclEntryName": "acl-2",
          "CidrBlock": "10.0.0.0/24",
          "Protocol": "all",
          "PortRange": "-1/-1",
          "Priority": 1,
          "Type": "system",
          "Description": "This is EgressAclEntries."
        }
      ],
      "Resources": [
        {
          "Status": "BINDING",
          "ResourceType": "Network",
          "ResourceId": "n-****",
          "EnsRegionId": "cn-fuzhou-telecom"
        }
      ]
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 NoPermission Permission denied.
    400 ens.interface.error Failed to call API. 介面調用發生異常。

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

    變更歷史

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