閱讀818 返回首頁    go 阿裏雲

查詢交換機列表__交換機相關接口_API 參考_雲服務器 ECS-阿裏雲

描述

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

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

請求參數

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

返回參數

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

錯誤碼

錯誤代碼 描述 Http 狀態碼 語義
Forbidden.VpcNotFound Specified VPC is not found during access authentication. 404 指定的 VPC 不存在

示例

請求示例

https://ecs.aliyuncs.com/?Action=DescribeVSwitches
&VpcId=vpc-25eq58pl3
&<公共請求參數>

返回示例

XML格式

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

最後更新：2016-11-23 16:03:50

  上一篇：go 刪除交換機__交換機相關接口_API 參考_雲服務器 ECS-阿裏雲
  下一篇：go 修改交換機屬性__交換機相關接口_API 參考_雲服務器 ECS-阿裏雲