阅读818 返回首页    go 阿里云 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-阿里云