查询VPC防火墙手动模式交换机列表。
接口说明
获取防火墙手动交换机列表。【必填参数】OwnerId（所属用户 ID，Long 类型）为空时返回 ErrorOwnerId；regionNo（地域）为空时返回 ErrorRegionNoError；vpcId 为空时返回 ErrorVpcIdError。【前置条件】可先调用 DescribeVpcFirewallList 获取：VpcFirewallId、OwnerId（取自响应的 LocalVpc.OwnerId 或 PeerVpc.OwnerId）、VpcId（取自 LocalVpc.VpcId 或 PeerVpc.VpcId）。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
yundun-cloudfirewall:DescribeVpcFirewallManualVSwitchList |
get |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Lang |
string |
否 |
请求和接收消息的语言类型。 枚举值：
|
zh |
| RegionNo |
string |
是 |
地域 ID。 |
cn-qingdao |
| VpcId |
string |
是 |
VPC 实例 ID。 |
vpc-m5ewlqkuf7orclr1**** |
| MemberUid |
string |
否 |
成员账号 UID。 |
18820897691**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| TotalCount |
integer |
返回结果的总条数。 |
3 |
| RequestId |
string |
返回结果的请求 ID。 |
6EED3674-74E7-54DC-8FD4-6A374133**** |
| VSwitchList |
array<object> |
交换机列表。 |
|
|
object |
交换机列表。 |
||
| Status |
string |
状态。 |
Available |
| VpcId |
string |
VPC 实例 ID。 |
vpc-uf62kq7c364sil2z2**** |
| VSwitchId |
string |
交换机 ID。 |
vsw-bp10d0kcp907721z**** |
| CidrBlock |
string |
IPv4 网段。 |
10.0.31.0/24 |
| AvailableIpAddressCount |
integer |
交换机中可用的 IP 地址数量。 |
10 |
| RegionNo |
string |
实例所在的地域 ID。 |
cn-beijing |
| ZoneId |
string |
可用区 ID。 |
cn-hangzhou-a |
| AliUid |
integer |
阿里云账号的 UID。 说明
云防火墙成员账号的主账号。 |
122167357026**** |
| RouteTableId |
string |
关联路由表 ID。 |
vtb-2zet3gyk01o07so**** |
| OwnerId |
integer |
所属用户 ID。 |
137578716100**** |
| VSwitchName |
string |
交换机的名称。 |
vsw-test |
示例
正常返回示例
JSON格式
{
"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"
}
]
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | ErrorAliUid | Aliuid invalid. | aliuid无效 |
| 400 | ErrorInvalidMemberUid | Member uid is invalid | 成员账号错误. |
| 400 | ErrorOwnerId | owner id invalid. | 所属账号错误，请重新输入。 |
| 400 | ErrorRegionNoError | Region invalid. | 地域选择错误， 请重新输入。 |
| 400 | ErrorVpcIdError | Vpc ID invalid. | VPC选择错误，请重新选择。 |
| 400 | ErrorDBSelectError | A database select error occurred. | 内部错误：数据库查询错误 |
| 400 | ErrorUserCredentials | User credentials failed. | 未授权，不可访问，请先授权防火墙权限。 |
| 400 | ErrorVpcOpenApi | vpc open api failed | 调用 VPC API 失败 |
| 400 | ErrorVswitchNotFound | vswitch not found | vswitch 不存在, 请重新选择 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。