查询交换机列表
描述
查询用户的 VSwitch 列表。此接口支持分页查询，每页的数量默认为 10 条。
该接口只会校验参数的合法性，不会校验参数之间的依赖关系，返回结果是所有条件的“交集”。
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| Action | String | 是 | 系统规定参数，取值：DescribeVSwitches |
| VpcId | String | 是 | VpcId |
| VSwitchId | String | 否 | 需要查询的 VSwitch 的 Id |
| ZoneId | String | 否 | 可用区 Id |
| IsDefault | Boolean | 否 | 是否为所属可用区下的默认交换机，可选值： true ——是 false ——否 不填写该参数时返回所有交换机Id |
| PageNumber | Integer | 否 | 实例状态列表的页码，起始值为 1，默认值为 1 |
| PageSize | Integer | 否 | 分页查询时设置的每页行数，最大值 50 行，默认为 10 |
返回参数
| 名称 | 类型 | 描述 |
|---|---|---|
| VSwitches | VSwitchType | VSwitch 详情 VSwitchSetType 组成的集合 |
| TotalCount | Integer | 列表条条目数 |
| PageNumber | Integer | 当前页码 |
| PageSize | Integer | 当前分页包含多少条目 |
错误码
| 错误代码 | 描述 | Http 状态码 | 语义 |
|---|---|---|---|
| Forbidden.VpcNotFound | Specified VPC is not found during access authentication. | 404 | 指定的 VPC 不存在 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=DescribeVSwitches
&VpcId=vpc-25eq58pl3
&<公共请求参数>
返回示例
JSON格式
{
"PageNumber": 1,
"PageSize": 10,
"RequestId": "9A572171-4E27-40D1-BD36-D26C9E71E29E",
"TotalCount": 1,
"VSwitches": {
"VSwitch": [
{
"AvailableIpAddressCount": 246,
"CidrBlock": "172.16.1.0/24",
"CreationTime": "2014-10-29T15:21:02Z",
"Description": "",
"Status": "Available",
"VSwitchId": "vsw-25b7pv15t",
"VSwitchName": "",
"VpcId": "vpc-257gq642n",
"ZoneId": "cn-beijing-a"
}
]
}
}
时间： 2025-01-21 08:00:19