All Products
Search
Document Center

:DescribeNatFirewallList

Last Updated:Sep 02, 2024

Queries details of NAT firewalls.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
LangstringNo

The language of the content within the response. Valid values:

  • zh (default)
  • en
zh
PageNolongNo

The page number.

1
PageSizelongNo

The number of entries per page.

Default value: 10.

Maximum value: 50.

10
ProxyIdstringNo

The ID of the NAT firewall.

proxy-nat97a******
ProxyNamestringNo

The name of the NAT firewall. The name must be 4 to 50 characters in length, and can contain letters, digits, and underscores (_). The name cannot start with an underscore.

proxy-******
RegionNostringNo

The region ID of the virtual private cloud (VPC).

cn-hangzhou
VpcIdstringNo

The ID of the VPC.

vpc-8vbwbo90rq0anm6t****
NatGatewayIdstringNo

The ID of the NAT gateway.

nat-bp123456g******
StatusstringNo

The status of the NAT firewall. Valid values:

  • configuring
  • deleting
  • normal
  • abnormal
  • opening
  • closing
  • closed
normal
MemberUidlongNo

The UID of the member that is managed by your Alibaba Cloud account.

147783******

Response parameters

ParameterTypeDescriptionExample
object
TotalCountinteger

The total number of NAT firewalls.

10
RequestIdstring

The request ID.

15FCCC52-1E23-57AE-B5EF-3E00A3******
NatFirewallListarray<object>

The NAT firewalls.

object
MemberUidlong

The UID of the member in Cloud Firewall.

19106481******
AliUidlong

The UID of the Alibaba Cloud account.

Note The value of this parameter indicates the management account to which the member is added.
19106481******
ProxyIdstring

The ID of the NAT firewall.

proxy-nat30******
ProxyNamestring

The name of the NAT firewall.

proxy-******
ProxyStatusstring

The status of the NAT firewall. Valid values:

  • configuring
  • deleting
  • normal
  • abnormal
  • opening
  • closing
  • closed
normal
RegionIdstring

The region ID of your Cloud Firewall.

Note For more information about the supported regions of Cloud Firewall, see Supported regions.
cn-qingdao
NatGatewayIdstring

The ID of the NAT gateway.

ngw-uf6tnblxip4qcxg******
NatGatewayNamestring

The name of the NAT gateway.

nat-******
VpcIdstring

The ID of the VPC.

vpc-2ze26ya******
VpcNamestring

The name of the VPC.

vpc-******
ErrorDetailstring

The cause of the error.

Create Failed.
StrictModeinteger

Indicates whether the strict mode is enabled. Valid values: 1, which specifies yes, and 0, which specifies no.

0
NatRouteEntryListarray<object>

The default route entries of the NAT gateway.

object
RouteTableIdstring

The route table to which the default route of the NAT gateway belongs.

vtb-bp18o0gb******
NextHopIdstring

The next hop of the original NAT gateway.

ngw-2ze0s284r9atg5******
NextHopTypestring

The network type of the next hop. The value is fixed as NatGateway.

NatGateway
DestinationCidrstring

The destination CIDR block of the default route.

0.0.0.0/0

Examples

Sample success responses

JSONformat

{
  "TotalCount": 10,
  "RequestId": "15FCCC52-1E23-57AE-B5EF-3E00A3******\n",
  "NatFirewallList": [
    {
      "MemberUid": 0,
      "AliUid": 0,
      "ProxyId": "proxy-nat30******",
      "ProxyName": "proxy-******",
      "ProxyStatus": "normal",
      "RegionId": "cn-qingdao",
      "NatGatewayId": "ngw-uf6tnblxip4qcxg******",
      "NatGatewayName": "nat-******",
      "VpcId": "vpc-2ze26ya******",
      "VpcName": "vpc-******",
      "ErrorDetail": "Create Failed.",
      "StrictMode": 0,
      "NatRouteEntryList": [
        {
          "RouteTableId": "vtb-bp18o0gb******",
          "NextHopId": "ngw-2ze0s284r9atg5******",
          "NextHopType": "NatGateway",
          "DestinationCidr": "0.0.0.0/0"
        }
      ]
    }
  ]
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2024-05-27The response structure of the API has changedView Change Details