Queries the usage of the reserved CIDR block for a vSwitch.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
vpc:GetVSwitchCidrReservationUsage |
get |
*VSwitchCidrReservation
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| VSwitchCidrReservationId |
string |
Yes |
The instance ID of the reserved CIDR block for a vSwitch that you want to query. |
vcr-bp1m12saqteraw3rp**** |
| NextToken |
string |
No |
The token for the next query. Valid values:
|
FFmyTO70tTpLG6I3FmYAXGKPd**** |
| MaxResults |
integer |
No |
The number of entries to return on each page. Valid values: 1 to 100. Default value: 10. |
10 |
| RegionId |
string |
Yes |
The region ID of the vSwitch. You can call the DescribeRegions operation to query region IDs. |
cn-hangzhou |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The request ID. |
||
| RequestId |
string |
The request ID. |
54B48E3D-DF70-471B-AA93-08E683A1B45 |
| NextToken |
string |
The token for the next query. Valid values:
|
FFmyTO70tTpLG6I3FmYAXGKPd**** |
| TotalCount |
integer |
The total number of entries. |
10 |
| MaxResults |
integer |
The number of entries returned per page. |
10 |
| CidrReservationUsages |
array<object> |
The list of allocated reserved CIDR block for a vSwitch. |
|
|
object |
The list of allocated reserved CIDR block for a vSwitch. |
||
| VSwitchCidrReservationId |
string |
The instance ID of the reserved CIDR block for a vSwitch. |
vcr-bp1m12saqteraw3rp**** |
| VSwitchId |
string |
The ID of the vSwitch to which the reserved CIDR block belongs. |
vsw-25navfgbue4g**** |
| ResourceId |
string |
The instance ID of the elastic network interfaces (ENIs) allocated from the reserved CIDR block. |
eni-bp14v2sdd3v8htln**** |
| ResourceType |
string |
The type of the instance allocated from the reserved CIDR block. Valid values: NetworkInterface, which indicates elastic network interfaces (ENIs). |
NetworkInterface |
| IpPrefixId |
string |
The instance ID of the reserved CIDR block that is allocated by prefix. |
vcr-bp1m12saqteraw3rp**** |
| IpPrefixCidr |
string |
The prefix CIDR block allocated to elastic network interfaces (ENIs) from the current reserved CIDR block. |
192.168.1.64/28 |
Examples
Success response
JSON format
{
"RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45",
"NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
"TotalCount": 10,
"MaxResults": 10,
"CidrReservationUsages": [
{
"VSwitchCidrReservationId": "vcr-bp1m12saqteraw3rp****",
"VSwitchId": "vsw-25navfgbue4g****",
"ResourceId": "eni-bp14v2sdd3v8htln****",
"ResourceType": "NetworkInterface",
"IpPrefixId": "vcr-bp1m12saqteraw3rp****",
"IpPrefixCidr": "192.168.1.64/28"
}
]
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | IllegalParam.NextToken | The specified NextToken is invalid. | The specified NextToken is invalid. |
| 404 | ResourceNotFound.CidrReservation | The specified resource of VSwitchCidrReservation is not found. | The error message returned because VSwitchCidrReservation is set to an invalid value. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.