调用DescribeNatGateways查询已创建的NAT网关。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeNatGateways

系统规定参数。取值：DescribeNatGateways。

EnsRegionId String 否 cn-wuxi-9

ENS节点ID。
NatGatewayId String 否 nat-5t7nh1cfm6kxiszlttr38****

NAT网关的ID。
NetworkId String 否 n-2zeuphj08tt7q3brd****

网络ID。
VSwitchId String 否 vsw-5rllcjb3ol6duzjdnbm1o****

交换机ID。
Name String 否 test0

NAT网关实例名称。
PageNumber Integer 否 1

查询列表的页码。起始值为1。

默认值：1。

PageSize Integer 否 10

分页查询时设置的每页行数，最大值为100行。

默认值：10。

返回数据

名称 类型 示例值 描述
RequestId String 2818A8F4-5E2B-5611-8732-5ACF7B677059

请求ID。
PageNumber Integer 1

当前查询页码。
TotalCount Integer 49

查询的NAT网关列表条目数。
PageSize Integer 10

分页查询时每页的行数。
NatGateways Array of NatGateway

NAT网关的详细信息。
EnsRegionId String cn-xiangyang-5

ENS节点ID。
NatGatewayId String nat-5t7nh1cfm6kxiszlttr38****

NAT网关的ID。
NetworkId String n-5s2ml1olj0kzaws9n1yrj****

网路ID。
VSwitchId String vsw-5szpp1os9m55myirbflfw****

交换机ID。
Name String test0

NAT网关实例名称。
CreationTime String 2021-11-22T07:03:32Z

创建时间。UTC时间，格式为：YYYY-MM-DDThh:mm:ssZ。
Spec String enat.default

NAT实例规格。

示例

请求示例

http(s)://ens.aliyuncs.com/?Action=DescribeNatGateways
&EnsRegionId=cn-wuxi-9
&NatGatewayId=nat-5t7nh1cfm6kxiszlttr38****
&NetworkId=n-2zeuphj08tt7q3brd****
&VSwitchId=vsw-5rllcjb3ol6duzjdnbm1o****
&Name=test0
&PageNumber=1
&PageSize=10
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeNatGatewaysResponse>
    <RequestId>2818A8F4-5E2B-5611-8732-5ACF7B677059</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>49</TotalCount>
    <PageSize>10</PageSize>
    <NatGateways>
        <EnsRegionId>cn-xiangyang-5</EnsRegionId>
        <NatGatewayId>nat-5t7nh1cfm6kxiszlttr38****</NatGatewayId>
        <NetworkId>n-5s2ml1olj0kzaws9n1yrj****</NetworkId>
        <VSwitchId>vsw-5szpp1os9m55myirbflfw****</VSwitchId>
        <Name>test0</Name>
        <CreationTime>2021-11-22T07:03:32Z</CreationTime>
        <Spec>enat.default</Spec>
    </NatGateways>
</DescribeNatGatewaysResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "2818A8F4-5E2B-5611-8732-5ACF7B677059",
  "PageNumber" : 1,
  "TotalCount" : 49,
  "PageSize" : 10,
  "NatGateways" : [ {
    "EnsRegionId" : "cn-xiangyang-5",
    "NatGatewayId" : "nat-5t7nh1cfm6kxiszlttr38****",
    "NetworkId" : "n-5s2ml1olj0kzaws9n1yrj****",
    "VSwitchId" : "vsw-5szpp1os9m55myirbflfw****",
    "Name" : "test0",
    "CreationTime" : "2021-11-22T07:03:32Z",
    "Spec" : "enat.default"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 Invalid%s The specified parameter %s is invalid. 参数不正确
400 Missing%s You must specify the parameter %s. 参数为必填
400 NoPermission Permission denied. 没有足够的权限，请联系云账号管理员授予您相应权限。

访问错误中心查看更多错误码。