阿里云如何使用查詢交換機列表接口

　　查詢交換機列表

　　描述

　　查詢用戶的 VSwitch 列表。此接口支持分頁查詢，每頁的數量默認為 10 條。

　　該接口只會校驗參數的合法性，不會校驗參數之間的依賴關系，返回結果是所有條件的“交集”。

　　請求參數

名稱 類型 是否必須 描述
Action   String   是   系統(tǒng)規(guī)定參數，取值：DescribeVSwitches  
VpcId   String   是   VpcId  
VSwitchId   String   否   需要查詢的 VSwitch 的 Id  
ZoneId   String   否   可用區(qū) Id  
IsDefault   Boolean   否   是否為所屬可用區(qū)下的默認交換機，可選值：
true ——是
false ——否
不填寫該參數時返回所有交換機Id  
PageNumber   Integer   否   實例狀態(tài)列表的頁碼，起始值為 1，默認值為 1  
PageSize   Integer   否   分頁查詢時設置的每頁行數，最大值 50 行，默認為 10  

　　返回參數

名稱 類型 描述
VSwitches   VSwitchType   VSwitch 詳情 VSwitchSetType 組成的集合  
TotalCount   Integer   列表條條目數  
PageNumber   Integer   當前頁碼  
PageSize   Integer   當前分頁包含多少條目  

　　錯誤碼

錯誤代碼 描述 Http 狀態(tài)碼 語義
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"