云主机 > API 文档 > VSwitch >虚拟交换机列表

虚拟交换机列表

最近更新时间: 2020-12-29 17:21:28

请求路径

GET /v1/vm/switch

请求参数

名称	类型	位置	必须	描述
region_id	string	query	否	地域 ID。您可以调用 DescribeRegions 查看最新的七牛云地域列表。
vpc_id	string	query	否	专有网络 ID
zone_id	string	query	否	可用区 ID。您可以通过调用DescribeZones接口获取可用区ID
page	integer	query	否	页码。默认：1
size	integer	query	否	分页大小，最大100。默认20

返回值

名称	类型	描述
request_id	string	请求 ID
page	integer	页码
size	integer	分页大小
total	integer	虚拟交换机总量
data	[]VSwitchInfo	虚拟交换机列表

VSwitchInfo

名称	类型	描述
v_switch_id	string	交换机的ID
vpc_id	string	交换机所属VPC的ID
status	string	交换机的状态，取值：Pending：配置中， Available：可用
cidr_block	string	交换机的IPv4网段
zone_id	string	交换机所属的可用区 ID
region_id	string	交换机所属的区域 ID
available_ip_address_count	integer	交换机中可用的IP地址数量
description	string	交换机的描述信息
v_switch_name	string	交换机的名称
is_default	boolean	是否为默认交换机，只能在创建的时候插入该字段
ipv6_cidr_block	string	交换机的IPv6网段
created_at	string	创建时间
updated_at	string	更新时间

返回值示例

{
  "data": [
    {
      "v_switch_id": "a88147c2-0d91-4727-9893",
      "vpc_id": "76b39642-dbdd-4e41-8e1c",
      "status": "Available",
      "cidr_block": "192.168.61.0/24",
      "zone_id": "grand-cn-north-4a",
      "region_id": "grand-cn-north-4",
      "available_ip_address_count": 251,
      "description": "System create default vswitch",
      "v_switch_name": "vswitch-default",
      "is_default": true,
      "client_token": "",
      "ipv6_cidr_block": "",
      "updated_at": "2020-12-01T15:04:54.121+08:00",
      "created_at": "2020-12-01T15:04:54.121+08:00"
    },
    {
      "v_switch_id": "7775f73d-1104-4758-97b2",
      "vpc_id": "76b39642-dbdd-4e41-8e1c",
      "status": "Available",
      "cidr_block": "192.168.0.0/24",
      "zone_id": "grand-cn-north-4g",
      "region_id": "grand-cn-north-4",
      "available_ip_address_count": 251,
      "description": "subnet-default",
      "v_switch_name": "subnet-default",
      "is_default": false,
      "client_token": "",
      "ipv6_cidr_block": "",
      "updated_at": "2020-11-12T17:09:25.283+08:00",
      "created_at": "2020-11-12T17:09:21.478+08:00"
    }
  ],
  "page": 1,
  "size": 10,
  "total": 2,
  "request_id": "N8cGFxnzdyenqFMW"
}

以上内容是否对您有帮助？