Queries the public IP address ranges of a virtual private cloud (VPC) in a specified region.
Operation description
You cannot use this operation to query public IP address ranges in the classic network.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| PageNumber |
integer |
No |
The page number. Default value: 1. |
1 |
| PageSize |
integer |
No |
The number of entries per page. Valid values: 1 to 100. Default value: 100. |
100 |
| RegionId |
string |
Yes |
The region to query. You can call the DescribeRegions operation to query the most recent region list. |
cn-hangzhou |
| RegionId |
string |
Yes |
The region to query. You can call the DescribeRegions operation to query the most recent region list. |
cn-hangzhou |
| IpVersion |
string |
No |
The IP version. Valid values:
|
ipv4 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response parameters. |
||
| RequestId |
string |
The request ID. |
54B48E3D-DF70-471B-AA93-08E683A1B45 |
| Success |
boolean |
Indicates whether the request is successful. Valid values:
|
true |
| Code |
string |
The HTTP status code. |
200 |
| Message |
string |
The response message. |
test |
| PageSize |
integer |
The number of entries per page. |
100 |
| PageNumber |
integer |
The page number. |
1 |
| TotalCount |
integer |
The total number of entries returned. |
1 |
| RegionId |
string |
The ID of the region to which the public IP addresses belong. |
cn-hangzhou |
| PublicIpAddress |
array |
The public IP address ranges of the VPC in the specified region. |
110.11.1.0/24 |
|
string |
A public IP address range of the VPC in the specified region. |
101.37.XX.XX/24 |
Examples
Success response
JSON format
{
"RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45",
"Success": true,
"Code": "200",
"Message": "test",
"PageSize": 100,
"PageNumber": 1,
"TotalCount": 1,
"RegionId": "cn-hangzhou",
"PublicIpAddress": [
"101.37.XX.XX/24"
]
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | IllegalParam.IpVersion | Param IpVersion illegal. | Illegal parameter: IpVersion |
| 403 | Forbidden | User not authorized to operate on the specified resource. | You do not have the permissions to manage the specified resource. Apply for the permissions and try again. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.