调用DescribeVSwitches接口查询已创建的交换机。

查询用户的 VSwitch 列表。此接口支持分页查询,每页的数量默认为 10 条。

该接口只会校验参数的合法性,不会校验参数之间的依赖关系,返回结果是所有条件的交集。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeVSwitches

要执行的操作。 取值: DescribeVSwitches

RegionId String cn-hangzhou

交换机所属VPC所在的地域。 您可以通过调用DescribeRegions接口获取地域ID。

IsDefault Boolean true

是否查询指定地域下的默认交换机,取值:

  • true(默认值):查询指定地域下的所有交换机。
  • false:不查询默认交换机。
PageNumber Integer 1

列表的页码,默认值为1

PageSize Integer 10

分页查询时每页的行数,最大值为50,默认值为10

ResourceGroupId String 1234567

资源组ID。

RouteTableId String vtb-bp145q7glnuzdvzu2****

路由表的ID。

VSwitchId String vsw-23dsf3****

交换机的ID。

VSwitchName String VSwitch-1

交换机的名称。

VpcId String vpc-25eq58pl****

VPC的ID。

ZoneId String cn-hangzhou-d

交换机所属区的ID。 您可以通过调用DescribeZones接口获取地域ID。

返回数据

名称 类型 示例值 描述
VSwitches

交换机的详细信息。

AvailableIpAddressCount Long 1

交换机中可用的IP地址数量。

CidrBlock String 172.16.0.0/24

交换机的网段。

CreationTime String 2018-01-18T12:43:57Z

交换机的创建时间。

Description String VSwitchDescription

交换机的描述信息。

Ipv6CidrBlock String 2408:4004:0:2900::/64

交换机的IPv6网段。

IsDefault Boolean true

是否是该可用区的默认交换机。

NetworkAclId String 1

网络ACL规则。

ResourceGroupId String rg-acfmxazb4ph6aiy****

交换机所属的资源组ID。

RouteTable

路由表信息。

RouteTableId String vrt-bp145q7glnuzdv****

交换机关联的路由表ID。

RouteTableType String System

路由表类型:

  • System:系统路由表
  • Custom:自定义路由表
Status String Available

交换机的状态,取值:

  • Pending:配置中
  • Available:可用
Tags

交换机标签信息。

Key String department

标签的键值。

Value String dev

标签取值。

VSwitchId String vsw-25b7pv1****

交换机的ID。

VSwitchName String VSwitch-1

交换机的名称。

VpcId String vpc-257gq64****

交换机所属VPC的ID。

ZoneId String cn-hangzhou-d

交换机所在的可用区。

TotalCount Integer 1

列表条条目数。

PageNumber Integer 1

当前页码。

PageSize Integer 10

每页包含多少条目。

RequestId String 9A572171-4E27-40D1-BD36-D26C9E71E29E

请求ID。

示例

请求示例


http(s)://vpc.aliyuncs.com/?Action=DescribeVSwitches
&<公共请求参数>

正常返回示例

XML 格式

<DescribeVSwitchesResponse>
      <RequestId>9A572171-4E27-40D1-BD36-D26C9E71E29E</RequestId>
      <VSwitches>
            <VSwitch>
                  <VSwitchId>vsw-25b7pv1****</VSwitchId>
                  <Status>Available</Status>
                  <CidrBlock>172.16.1.0/24</CidrBlock>
                  <ZoneId>cn-beijing-a</ZoneId>
                  <AvailableIpAddressCount>246</AvailableIpAddressCount>
                  <VpcId>vpc-257gq64****</VpcId>
                  <Description></Description>
                  <VSwitchName></VSwitchName>
                  <CreationTime> 2014-10-29T15:21:02Z </CreationTime>
            </VSwitch>
      </VSwitches>
</DescribeVSwitchesResponse>

JSON 格式

{
	"PageNumber":1,
	"VSwitches":{
		"VSwitch":[
			{
				"CreationTime":"2014-10-29T15:21:02Z",
				"Status":"Available",
				"CidrBlock":"172.16.1.0/24",
				"Description":"",
				"AvailableIpAddressCount":246,
				"VSwitchName":"",
				"ZoneId":"cn-beijing-a",
				"VSwitchId":"vsw-25b7pv1****",
				"VpcId":"vpc-257gq****"
			}
		]
	},
	"TotalCount":1,
	"PageSize":10,
	"RequestId":"9A572171-4E27-40D1-BD36-D26C9E71E29E"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidVSwitchId.NotFound VSwitch not exist. 该交换机不存在,请您检查输入的交换机是否正确。
400 Forbidden.VpcNotFound Specified VPC can not found. 指定的 VPC 不存在,请您检查 VPC 是否正确。

访问错误中心查看更多错误码。