Queries the list of vSwitches for a VPC firewall created in manual mode.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| Lang |
string |
No |
The language of request and response messages. Valid values:
|
zh |
| Lang |
string |
No |
The language of the request and response. Valid values:
|
zh |
| RegionNo |
string |
Yes |
The region ID. |
cn-qingdao |
| VpcId |
string |
Yes |
The ID of the VPC instance. |
vpc-m5ewlqkuf7orclr1**** |
| MemberUid |
string |
No |
The UID of the member account. |
18820897691**** |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| TotalCount |
integer |
The total number of entries returned. |
3 |
| RequestId |
string |
The ID of the request. |
6EED3674-74E7-54DC-8FD4-6A374133**** |
| VSwitchList |
array<object> |
The list of vSwitches. |
|
|
object |
A list of vSwitches. |
||
| Status |
string |
The status. |
Available |
| VpcId |
string |
The ID of the VPC instance. |
vpc-uf62kq7c364sil2z2**** |
| VSwitchId |
string |
The ID of the vSwitch. |
vsw-bp10d0kcp907721z**** |
| CidrBlock |
string |
The IPv4 CIDR block. |
10.0.31.0/24 |
| AvailableIpAddressCount |
integer |
The number of available IP addresses in the vSwitch. |
10 |
| RegionNo |
string |
The region ID of the instance. |
cn-beijing |
| ZoneId |
string |
The zone ID. |
cn-hangzhou-a |
| AliUid |
integer |
The UID of the Alibaba Cloud account. Note
The root account of the Cloud Firewall member account. |
122167357026**** |
| RouteTableId |
string |
The ID of the associated route table. |
vtb-2zet3gyk01o07so**** |
| OwnerId |
integer |
The ID of the owner. |
137578716100**** |
| VSwitchName |
string |
The name of the vSwitch. |
vsw-test |
Examples
Success response
JSON format
{
"TotalCount": 3,
"RequestId": "6EED3674-74E7-54DC-8FD4-6A374133****",
"VSwitchList": [
{
"Status": "Available",
"VpcId": "vpc-uf62kq7c364sil2z2****",
"VSwitchId": "vsw-bp10d0kcp907721z****",
"CidrBlock": "10.0.31.0/24",
"AvailableIpAddressCount": 10,
"RegionNo": "cn-beijing",
"ZoneId": "cn-hangzhou-a",
"AliUid": 0,
"RouteTableId": "vtb-2zet3gyk01o07so****",
"OwnerId": 0,
"VSwitchName": "vsw-test"
}
]
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | ErrorAliUid | Aliuid invalid. | The aliuid is invalid. |
| 400 | ErrorInvalidMemberUid | Member uid is invalid | The member is invalid. |
| 400 | ErrorOwnerId | owner id invalid. | The account is incorrect, please re-enter. |
| 400 | ErrorRegionNoError | Region invalid. | Region selection error, please re-enter. |
| 400 | ErrorVpcIdError | Vpc ID invalid. | The VPC is incorrectly selected. Select another VPC. |
| 400 | ErrorDBSelectError | A database select error occurred. | The error message returned because an internal error has occurred in querying the database. |
| 400 | ErrorUserCredentials | User credentials failed. | Unauthorized, not accessible, please first authorize firewall permissions. |
| 400 | ErrorVpcOpenApi | vpc open api failed | Failed to call the VPC API. |
| 400 | ErrorVswitchNotFound | vswitch not found | The vSwitch does not exist. Select another vSwitch. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.