查詢已建立的交換器。

請求參數

名稱 類型 是否必須 描述
Action String 是

要執行的操作。 取值：

DescribeVSwitches
RegionId String 是

交換器所屬VPC所在的地域。

您可以通過調用 DescribeRegions介面獲取地域ID。

VpcId String 否

VPC的ID。
ZoneId String 否

交換器所屬區的ID。

您可以通過調用 DescribeZones介面獲取地域ID。

VSwitchId String 否

交換器的ID。
IsDefault Boolean 否

是否查詢指定地域下的預設交換器，取值：

  • true（預設值）：查詢指定地域下的所有交換器。
  • false：不查詢預設交換器。
PageNumber Integer 否

列表的頁碼，預設值為1。

PageSize Integer 否

分頁查詢時每頁的行數，最大值為50，預設值為10。

返回參數

名稱 類型 描述
RequestId String 請求ID。
TotalCount String 列表條條目數。
PageNumber Integer 當前頁碼。
PageSize String 每頁包含多少條目。
VSwitches JSON String 交換器的詳細資料。
表 1. VSwitch
名稱 類型 描述
VpcId String 交換器所屬VPC的ID。
VSwitchId String 交換器的ID。
Status String 交換器的狀態，取值：

  • Pending：配置中

  • Available：可用

CidrBlock String 交換器的網段。
ZoneId String 交換器所在的可用性區域。
AvailableIpAddressCount Integer 交換器中可用的IP地址數量。
VSwitchName String 交換器的名稱。
Description String 交換器的描述資訊。
CreationTime String 交換器的建立時間。
IsDefault Boolean 是否是該可用性區域的預設交換器。

樣本

請求樣本

https://vpc.aliyuncs.com/?Action=DescribeVSwitches
&VpcId=vpc-25eq58pl3
&公共請求參數
返回樣本

  • XML格式

    <?xml version="1.0" encoding="UTF-8"?>
<DescribeVSwitchesResponse>
    <RequestId>9A572171-4E27-40D1-BD36-D26C9E71E29E</RequestId>
    <VSwitches>
        <VSwitch>
            <VSwitchId> vsw-25b7pv15t </VSwitchId>
            <Status>Available</Status>
            <CidrBlock>172.16.1.0/24</CidrBlock>
            <ZoneId>cn-beijing-a</ZoneId>
            <AvailableIpAddressCount>246</AvailableIpAddressCount>
            <VpcId>vpc-257gq642n</VpcId>
            <Description></Description>
            <VSwitchName></VSwitchName>
            <CreationTime> 2014-10-29T15:21:02Z </CreationTime>
        </VSwitch>
    </VSwitches>
</DescribeVSwitchesResponse>

  • 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"
      }
    ]
  }
}