首页 专有网络 VPC 开发参考 API参考 API目录 NAT NatIp管理 NatIpCidr ListNatIpCidrs - 查询NAT IP地址段列表

ListNatIpCidrs - 查询NAT IP地址段列表

更新时间: 2023-12-06 18:38:11

调用ListNatIpCidrs接口查询NAT IP地址段列表。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
RegionIdstring

需要查询的NAT IP地址段所属VPC NAT网关的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

eu-central-1
NatGatewayIdstring

要查询NAT IP地址段的VPC NAT网关的实例ID。

ngw-gw8v16wgvtq26vh59****
NatIpCidrstring

要查询的NAT IP地址段。

172.16.0.0/24
DryRunboolean

是否只预检此次请求,取值:

  • true:发送检查请求,不会查询NAT IP地址段列表。检查项包括AccessKey是否有效、RAM用户的授权情况和是否填写了必需参数。如果检查不通过,则返回对应错误。如果检查通过,会返回错误码DryRunOperation。

  • false(默认值):发送正常请求,通过检查后返回HTTP 2xx状态码并查询NAT IP地址段列表。

false
ClientTokenstring

客户端Token,用于保证请求的幂等性。

由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符。

说明 若您未指定,则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
5A2CFF0E-5718-45B5-9D4D-70B3FF3898
NatIpCidrStatusstring

要查询的NAT IP地址段的状态。取值:Available,表示可用状态。

Available
NextTokenstring

是否拥有下一次查询的令牌(Token)。取值:

  • 第一次查询和没有下一次查询时,均无需填写。
  • 如果有下一次查询,取值为上一次API调用返回的NextToken值。
caeba0bbb2be03f84eb48b699f0a4883
MaxResultsstring

分批次查询时每次显示的条目数。取值范围:1~100,默认值为20

20
NatIpCidrNamearray

要查询的NAT IP地址段的名称。N取值为1~20

string

要查询的NAT IP地址段的名称。N取值为1~20

cidrname
NatIpCidrsarray

要查询的NAT IP地址段。N取值为1~20

string

要查询的NAT IP地址段。N取值为1~20

172.16.0.0/24

返回参数

名称类型描述示例值
object
NextTokenstring

是否拥有下一次查询的令牌(Token)。取值:

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值,该取值表示下一次查询开始的令牌。
caeba0bbb2be03f84eb48b699f0a4883
RequestIdstring

请求ID。

7479A224-4A28-4895-9604-11F48BCE6A88
TotalCountstring

查询到的NAT IP地址段的列表条目数。

1
NatIpCidrsobject []

NAT IP地址段列表。

CreationTimestring

NAT IP地址段的创建时间。

2021-06-28T20:50Z
NatIpCidrIdstring

NAT IP地址段实例ID。

vpcnatcidr-gw8ov42ei6xh1jys2****
IsDefaultboolean

是否为默认NAT IP地址段。取值:

  • true:是默认NAT IP地址段。
  • false:不是默认NAT IP地址段。
true
NatIpCidrStatusstring

NAT IP地址段的状态。取值:Available,表示可用状态。

Available
NatIpCidrNamestring

NAT IP地址段的名称。

Name
NatIpCidrstring

NAT IP地址段。

172.16.0.0/24
NatGatewayIdstring

NAT IP地址段所属的VPC NAT网关实例ID。

ngw-gw8v16wgvtq26vh59****
NatIpCidrDescriptionstring

NAT IP地址段的描述信息。

test

示例

正常返回示例

JSON格式

{
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId": "7479A224-4A28-4895-9604-11F48BCE6A88",
  "TotalCount": "1",
  "NatIpCidrs": [
    {
      "CreationTime": "2021-06-28T20:50Z",
      "NatIpCidrId": "vpcnatcidr-gw8ov42ei6xh1jys2****",
      "IsDefault": true,
      "NatIpCidrStatus": "Available",
      "NatIpCidrName": "Name",
      "NatIpCidr": "172.16.0.0/24",
      "NatGatewayId": "ngw-gw8v16wgvtq26vh59****",
      "NatIpCidrDescription": "test"
    }
  ]
}

错误码

HTTP status code错误码错误信息描述
404InvalidRegionId.NotFoundThe specified RegionId does not exist in our records.指定的RegionId不存在。

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

变更历史

变更时间变更内容概要操作
2023-03-01OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:404
阿里云首页 专有网络 VPC 相关技术圈