调用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"
  }
}

错误码

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