すべてのプロダクト
Search

このプロダクト

    ENS:DescribeNetworkAcls

    ドキュメントセンター

    ENS:DescribeNetworkAcls

    最終更新日:Mar 20, 2026

    この API を使用すると、作成済みのネットワーク ACL を照会できます。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ens:DescribeNetworkAcls

    list

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    NetworkAclId

    string

    任意

    ネットワーク ACL の ID です。

    nacl-bp1lhl0taikrbgnh****
    NetworkAclName

    string

    任意

    ネットワーク ACL の名前です。

    acl-1
    ResourceId

    string

    任意

    関連付けられたインスタンスの ID です。

    n-5****
    PageNumber

    string

    任意

    ページ番号です。ページは 1 から始まります。デフォルト値は 1 です。

    1
    PageSize

    string

    任意

    1 ページあたりの表示件数です。最大値は 50、デフォルト値は 10 です。

    10

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答のスキーマです。

    RequestId

    string

    リクエストの ID です。

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

    string

    返された合計件数です。

    3
    PageSize

    string

    1 ページあたりの表示件数です。

    2
    PageNumber

    string

    ページ番号です。

    1
    NetworkAcls

    array<object>

    ネットワーク ACL の詳細情報です。

    array<object>

    Status

    string

    ネットワーク ACL のステータスです。有効な値は以下のとおりです。

    • Available: ネットワーク ACL が利用可能です。

    • Modifying: ネットワーク ACL の設定中です。

    Available
    CreationTime

    string

    ネットワーク ACL の作成時刻です。ISO 8601 標準に従い、yyyy-MM-ddTHH:mm:ssZ 形式で表されます。時刻は協定世界時 (UTC) で表示されます。

    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

    送信元 CIDR ブロックです。

    10.0.0.0/24
    Protocol

    string

    プロトコルの種類です。有効な値は以下のとおりです。

    • icmp: ICMP。

    • tcp: TCP。

    • udp: UDP。

    • all: すべてのプロトコル。

    all
    PortRange

    string

    インバウンドルールの宛先ポート範囲です。

    • インバウンドルールの Protocol が all または icmp の場合、ポート範囲は -1/-1（すべてのポート）になります。

    • インバウンドルールの Protocol が tcp または udp の場合、ポート範囲は 1/200 や 80/80 の形式になります。1/200 はポート 1 ～ 200 を意味し、80/80 はポート 80 を意味します。ポートの有効値は 1 ～ 65535 です。

    -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

    宛先 CIDR ブロックです。

    10.0.0.0/24
    Protocol

    string

    プロトコルの種類です。有効な値は以下のとおりです。

    • icmp: ICMP。

    • tcp: TCP。

    • udp: UDP。

    • all: すべてのプロトコル。

    all
    PortRange

    string

    アウトバウンドルールの宛先ポート範囲です。

    • アウトバウンドルールの Protocol が all または icmp の場合、ポート範囲は -1/-1（すべてのポート）になります。

    • アウトバウンドルールの Protocol が tcp または udp の場合、ポート範囲は 1/200 や 80/80 の形式になります。1/200 はポート 1 ～ 200 を意味し、80/80 はポート 80 を意味します。ポートの有効値は 1 ～ 65535 です。

    -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: リソースがネットワーク ACL に関連付けられています。

    • BINDING: リソースがネットワーク ACL に関連付けられようとしています。

    • UNBINDING: リソースがネットワーク ACL から関連付け解除されようとしています。

    BINDING
    ResourceType

    string

    関連付けられたリソースの種類です。

    Network
    ResourceId

    string

    関連付けられたリソースの ID です。

    n-****
    EnsRegionId

    string

    エッジノードの ID です。

    cn-fuzhou-telecom

    例

    成功レスポンス

    JSONJSON

    {
  "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 ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 NoPermission Permission denied.
    400 ens.interface.error Failed to call API.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。