すべてのプロダクト
Search

このプロダクト

    Cloud Firewall:DescribeNatFirewallList

    ドキュメントセンター

    Cloud Firewall:DescribeNatFirewallList

    最終更新日:Aug 02, 2026

    NAT ファイアウォールの詳細を取得します。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    yundun-cloudfirewall:DescribeNatFirewallList

    get

    *NatFirewall。

    acs:cloudfirewall::{#accountId}:natfirewall/{#ProxyId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Lang

    string

    任意

    応答の言語。有効な値:

    • zh (デフォルト): 中国語

    • en: 英語

    zh
    PageNo

    integer

    任意

    現在のページのページ番号。

    1
    PageSize

    integer

    任意

    ページングクエリで各ページに表示する NAT ファイアウォールの数。

    デフォルト値: 10。各ページに 10 件の結果が含まれることを示します。最大値: 50。

    10
    ProxyId

    string

    任意

    NAT ファイアウォールの ID。

    proxy-nat97a******
    ProxyName

    string

    任意

    NAT ファイアウォールの名前。名前には大文字、小文字、漢字、数字、アンダースコア (_) を含めることができます。名前の長さは 4～50 文字で、アンダースコアで始めることはできません。

    nat-ファイアウォール
    RegionNo

    string

    任意

    VPC のリージョン ID。

    説明

    Cloud Firewall でサポートされているリージョンの詳細については、「サポートされているリージョン」をご参照ください。

    cn-hangzhou
    VpcId

    string

    任意

    VPC に接続されたインスタンスの ID。

    vpc-8vbwbo90rq0anm6t****
    NatGatewayId

    string

    任意

    NAT ゲートウェイの ID。

    ngw-bp123456g******
    Status

    string

    任意

    Cloud Firewall のステータス。有効な値:

    • configuring: 作成中

    • deleting: 削除中

    • normal: 正常

    • abnormal: 異常

    • opening: 有効化中

    • closing: 無効化中

    • closed: 無効

    normal
    MemberUid

    integer

    任意

    現在の Alibaba Cloud アカウントのメンバーアカウントの UID。

    147783******

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    TotalCount

    integer

    NAT ファイアウォールの総数。

    10
    RequestId

    string

    リクエスト ID。

    15FCCC52-1E23-57AE-B5EF-3E00A3******
    NatFirewallList

    array<object>

    Cloud Firewall のリスト。

    array<object>

    Cloud Firewall のリスト。

    MemberUid

    integer

    Cloud Firewall メンバーアカウントの UID。

    19106481******
    AliUid

    integer

    Alibaba Cloud アカウントの UID。

    説明

    Cloud Firewall メンバーアカウントの管理アカウント。

    19106481******

    ProxyId

    string

    NAT ファイアウォールの ID。

    proxy-nat30******
    ProxyName

    string

    NAT ファイアウォールの名前。

    nat-ファイアウォール-test
    ProxyStatus

    string

    Cloud Firewall のステータス。有効な値:

    • configuring: 作成中

    • deleting: 削除中

    • normal: 正常

    • abnormal: 異常

    • opening: 有効化中

    • closing: 無効化中

    • closed: 無効

    normal
    RegionId

    string

    Cloud Firewall のリージョン ID。

    説明

    Cloud Firewall でサポートされているリージョンの詳細については、「サポートされているリージョン」をご参照ください。

    cn-qingdao
    NatGatewayId

    string

    クエリ対象の NAT ゲートウェイの ID。

    ngw-uf6tnblxip4qcxg******
    NatGatewayName

    string

    NAT ゲートウェイの名前。

    nat-ゲートウェイ-test
    VpcId

    string

    VPC に接続されたインスタンスの ID。

    vpc-2ze26ya******
    VpcName

    string

    VPC インスタンスの名前。

    vpc-test-インスタンス
    ErrorDetail

    string

    エラーの詳細。

    Firewall creation failed
    StrictMode

    integer

    Strict モードが有効かどうかを示します。

    • 1: Strict モードが有効です。

    • 0: Strict モードが無効です。

    0
    NatRouteEntryList

    array<object>

    NAT ゲートウェイのデフォルトルートエントリのリスト。

    object

    NAT ゲートウェイのデフォルトルートエントリ。

    RouteTableId

    string

    NAT ゲートウェイのデフォルトルートを含むルートテーブル。

    vtb-bp18o0gb******
    NextHopId

    string

    NAT ゲートウェイの元のネクストホップアドレス。

    ngw-2ze0s284r9atg5******
    NextHopType

    string

    ネクストホップのネットワークタイプ。有効な値: NatGateway。

    NatGateway。
    DestinationCidr

    string

    デフォルトルートの送信先 CIDR ブロック。

    0.0.0.0/0
    ProxyVSwitchId

    string

    ファイアウォールで使用される vSwitch の ID。

    vsw-bp1amn3t1ktjjy8******
    ProxyRouteTableId

    string

    ファイアウォールで使用されるルートテーブルの ID。

    vtb-bp1pmyga7p4j10a******
    ProxyNetworkInterfaceId

    string

    ファイアウォールで使用されるネットワークインターフェイス (ENI) の ID。

    eni-bp127llmo4v5qju******
    FirewallServiceMode

    string

    NAT ファイアウォールサービスの Deployment モード。有効な値: PrimaryStandby (アクティブな/スタンバイモード)、MultiPrimary (アクティブな/アクティブなモード)。

    PrimaryStandby
    FirewallServiceZones

    array

    NAT ファイアウォールサービスで使用されるゾーン ID のリスト。

    string

    NAT ファイアウォールサービスで使用されるゾーンの ID。

    cn-hangzhou-i

    例

    成功レスポンス

    JSONJSON

    {
  "TotalCount": 10,
  "RequestId": "15FCCC52-1E23-57AE-B5EF-3E00A3******",
  "NatFirewallList": [
    {
      "MemberUid": 0,
      "AliUid": 0,
      "ProxyId": "proxy-nat30******",
      "ProxyName": "nat-ファイアウォール-test",
      "ProxyStatus": "normal。",
      "RegionId": "cn-qingdao。",
      "NatGatewayId": "ngw-uf6tnblxip4qcxg******",
      "NatGatewayName": "nat-ゲートウェイ-test",
      "VpcId": "vpc-2ze26ya******",
      "VpcName": "vpc-test-インスタンス",
      "ErrorDetail": "Firewall creation failed。",
      "StrictMode": 0,
      "NatRouteEntryList": [
        {
          "RouteTableId": "vtb-bp18o0gb******",
          "NextHopId": "ngw-2ze0s284r9atg5******",
          "NextHopType": "NatGateway。",
          "DestinationCidr": "0.0.0.0/0"
        }
      ],
      "ProxyVSwitchId": "vsw-bp1amn3t1ktjjy8******",
      "ProxyRouteTableId": "vtb-bp1pmyga7p4j10a******",
      "ProxyNetworkInterfaceId": "eni-bp127llmo4v5qju******",
      "FirewallServiceMode": "PrimaryStandby",
      "FirewallServiceZones": [
        "cn-hangzhou-i"
      ]
    }
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 ErrorAliUid Aliuid invalid.
    400 ErrorPageNo Either page number or page size is invalid.
    400 ErrorDBSelectError A database select error occurred.
    400 ErrorNatGatewayNotAvailable Nat gateway not available.
    400 ErrorDnatNotSupport NAT firewall does not support DAT entries.
    400 ErrorProxySnatIpEmpty SNAT entry is empty.

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

    変更履歴

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