调用DescribeVSwitches获取指定地域，指定VPC内的虚拟交换机列表。

调试

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

请求参数

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

系统规定参数。取值：DescribeVSwitches。

RegionId String 是 cn-hangzhou

地域ID
VpcId String 是 vpc-bp17gig441u0msmd78****

VPC ID

返回数据

名称 类型 示例值 描述
TotalCount Integer 10

TotalCount本次请求条件下的数据总量，此参数为可选参数，默认可不返回
RequestId String BD65C0AD-D3C6-48D3-8D93-38D2015C****

请求ID
NextToken String “”

表示当前调用返回读取到的位置，空代表数据已经读取完毕
MaxResults Integer 10

本次请求所返回的最大记录条数
VSwitches Array of VSwitches

可用的虚拟交换机列表
VpcId String vpc-bp17gig441u0msmd6****

交换机所在VPC的ID
VSwitchId String vsw-bp1g24p9no0iqir46****

虚拟交换机ID
Status String Available

虚拟交换机的状态，取值：

  • Pending：配置中
  • Available：可用
IsDefault Boolean false

是否是默认交换机，取值：

  • true：默认交换机
  • false：不是默认交换机
VSwitchName String vsw-test

虚拟交换机名称

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeVSwitches
&RegionId=cn-hangzhou
&VpcId=vpc-bp17gig441u0msmd78****
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeVSwitchesResponse>
    <TotalCount>10</TotalCount>
    <RequestId>BD65C0AD-D3C6-48D3-8D93-38D2015C****</RequestId>
    <NextToken>“”</NextToken>
    <MaxResults>10</MaxResults>
    <VSwitches>
        <VpcId>vpc-bp17gig441u0msmd6****</VpcId>
        <VSwitchId>vsw-bp1g24p9no0iqir46****</VSwitchId>
        <Status>Available</Status>
        <IsDefault>false</IsDefault>
        <VSwitchName>vsw-test</VSwitchName>
    </VSwitches>
</DescribeVSwitchesResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 10,
  "RequestId" : "BD65C0AD-D3C6-48D3-8D93-38D2015C****",
  "NextToken" : "“”",
  "MaxResults" : 10,
  "VSwitches" : {
    "VpcId" : "vpc-bp17gig441u0msmd6****",
    "VSwitchId" : "vsw-bp1g24p9no0iqir46****",
    "Status" : "Available",
    "IsDefault" : false,
    "VSwitchName" : "vsw-test"
  }
}

错误码

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