全部产品
Search
文档中心

专有网络 VPC:ListNatIpCidrs - 查询NAT IP地址段列表

更新时间:Mar 04, 2024

调用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