阅读137 返回首页    go 阿里云 go 技术社区[云栖]

查询NAT网关列表__NAT网关相关接口_API 参考_云服务器 ECS-阿里云

描述

查询指定地域的NatGateway列表。此接口支持分页查询，每页的数量默认为 10 条。

请求参数

名称 类型 是否必须 描述
Action String 是 系统规定参数，取值：DescribeNatGateways
RegionId String 是 指定查询进行的地域
NatGatewayId String 否 过滤类参数，即，只返回指定NatGatewayId的结果；
不指定该参数则为不过滤。
VpcId String 否 过滤类参数，即，只返回指定VPC内的NatGateway.
不指定该参数则为不过滤。
PageNumber Integer 否 实例状态列表的页码，起始值为 1，默认值为 1
PageSize Integer 否 分页查询时设置的每页行数，最大值 50 行，默认为 10

返回参数

名称 类型 描述
NatGateways NatGatewaySetType NatGateway列表
TotalCount Integer 列表条条目数
PageNumber Integer 当前页码
PageSize Integer 当前分页包含多少条目

错误码

错误代码 描述 Http 状态码 语义
InvalidRegionId.NotFound Specified value of “RegionId” is not supported. 404 指定的 Region 不存在

示例

请求示例

  1. https://ecs.aliyuncs.com/?SignatureVersion=1.0&VpcId=vpc-11af8lp67&Format=json&TimeStamp=2016-05-23T03%3A27%3A14Z&RegionId=cn-shanghai&AccessKeyId=jZgi0oyrQ6ihgKp9&SignatureMethod=HMAC-SHA1&Version=2014-05-26&Signature=JvXErso9g0fZdRTgBtNLepe%2F1e4%3D&action=DescribeNatGateways&SignatureNonce=3e1424eb-2096-11e6-bc31-2cf0ee28adf2

返回示例

JSON格式

  1. {
  2.   "NatGateways": {
  3.     "NatGateway": [
  4.       {
  5.         "BandwidthPackageIds": {
  6.           "BandwidthPackageId": [
  7.             "bwp-11odxu2k7"
  8.           ]
  9.         },
  10.         "BusinessStatus": "Normal",
  11.         "CreationTime": "2016-05-23T03:26:23Z",
  12.         "Description": "My first NAT Gateway",
  13.         "ForwardTableIds": {
  14.           "ForwardTableId": [
  15.             "ftb-11tc6xgmv"
  16.           ]
  17.         },
  18.         "InstanceChargeType": "PostPaid",
  19.         "Name": "MyNatGW",
  20.         "NatGatewayId": "ngw-112za33e4",
  21.         "RegionId": "cn-shanghai",
  22.         "Spec": "Small",
  23.         "Status": "Available",
  24.         "VpcId": "vpc-11af8lp67"
  25.       }
  26.     ]
  27.   },
  28.   "PageNumber": 1,
  29.   "PageSize": 10,
  30.   "RequestId": "FE4C442C-9778-449A-BF7F-7F36C3AF5611",
  31.   "TotalCount": 1
  32. }

XML格式

暂略；

最后更新：2016-11-23 16:04:11

  上一篇：go 创建NAT网关__NAT网关相关接口_API 参考_云服务器 ECS-阿里云
  下一篇：go 删除NAT网关__NAT网关相关接口_API 参考_云服务器 ECS-阿里云