調用ListNatIpCidrs接口查詢NAT IP地址段列表。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
當前API暫無授權信息透出。
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 需要查詢的 NAT IP 地址段所屬 VPC NAT 網關的地域 ID。 您可以通過調用 DescribeRegions 接口獲取地域 ID。 | eu-central-1 |
| NatGatewayId | string | 是 | 要查詢 NAT IP 地址段的 VPC NAT 網關的實例 ID。 | ngw-gw8v16wgvtq26vh59**** |
| NatIpCidr | string | 否 | 要查詢的 NAT IP 地址段。 | 172.16.0.0/24 |
| DryRun | boolean | 否 | 是否只預檢此次請求，取值：
| false |
| ClientToken | string | 否 | 客戶端 Token，用于保證請求的冪等性。 由客戶端生成該參數值，要保證在不同請求間唯一，最大值不超過 64 個 ASCII 字符。 說明
若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。
| 5A2CFF0E-5718-45B5-9D4D-70B3FF3898 |
| NatIpCidrStatus | string | 否 | 要查詢的 NAT IP 地址段的狀態。取值：Available，表示可用狀態。 | Available |
| NextToken | string | 否 | 是否擁有下一次查詢的令牌（Token）。取值：
| caeba0bbb2be03f84eb48b699f0a4883 |
| MaxResults | string | 否 | 分批次查詢時每次顯示的條目數。取值范圍：1~100，默認值為 20。 | 20 |
| NatIpCidrName | array | 否 | 要查詢的 NAT IP 地址段的名稱。N 取值為 1~20。 | |
| string | 否 | 要查詢的 NAT IP 地址段的名稱。N 取值為 1~20。 | cidrname | |
| NatIpCidrs | array | 否 | 要查詢的 NAT IP 地址段。N 取值為 1~20。 | |
| string | 否 | 要查詢的 NAT IP 地址段。N 取值為 1~20。 | 172.16.0.0/24 |
返回參數
示例
正常返回示例
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 | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist in our records. | 指定的RegionId不存在。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-07-23 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-03-01 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |