云主机 > API 文档 > VPC >专有网络列表

专有网络列表

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

请求路径

GET /v1/vm/vpc

请求参数

名称	类型	位置	必须	描述
region_id	string	query	否	地域 ID。您可以调用 DescribeRegions 查看最新的七牛云地域列表。
vpc_id	string	query	否	专有网络 ID
vpc_name	string	query	否	专有网络名称
cidr_block	string	query	否	专有网络的网段您可以使用以下网段或其子集作为VPC的网段： 172.16.0.0/12（默认值）。 10.0.0.0/8。 192.168.0.0/16。
page	integer	query	否	页码。默认：1
size	integer	query	否	分页大小，最大100。默认20

返回值

名称	类型	描述
request_id	string	请求 ID
page	integer	页码
size	integer	分页大小
total	integer	VPC 总量
data	[]VPCInfo	VPC 列表

VPCInfo

名称	类型	描述
vpc_id	string	VPC ID
region_id	string	VPC所在的地域
status	string	VPC的状态，取值：Pending：配置中， Available：可用
vpc_name	string	VPC 的名称
v_switch_ids	object{“v_switch_id”: []string}	VPC 中交换机的列表
cidr_block	string	VPC 的 IPv4 网段
v_router_id	string	VPC 路由器的 ID
description	string	VPC 的描述信息
is_default	bool	是否为默认 VPC，只能在创建的时候插入该字段
ipv6_cidr_block	string	交换机的 IPv6 网段
bind_ipv6_gateway	bool	是否绑定 IPv6 网关
cen_status	string	VPC绑定云企业网的状态: Detached：未绑定云企业网， Available：已绑定云企业网
route_table_id	string	路由表的ID
client_token	string	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一
created_at	string	创建时间
updated_at	string	更新时间

返回值示例

{
  "data": [
    {
      "vpc_id": "76b39642-dbdd-4e41-8e1c-e1",
      "region_id": "grand-cn-north-4",
      "status": "Available",
      "vpc_name": "vpc-default",
      "v_switch_ids": {
        "v_switch_id": [
          "a88147c2-0d91-4727-9893",
          "7775f73d-1104-4758-97b2"
        ]
      },
      "cidr_block": "192.168.0.0/16",
      "v_router_id": "",
      "description": "vpc-default",
      "is_default": false,
      "ipv6_cidr_block": "",
      "bind_ipv6_gateway": false,
      "cen_status": "",
      "route_table_id": "",
      "client_token": "",
      "updated_at": "2020-12-24T19:49:55.135+08:00",
      "created_at": "2020-11-12T17:09:18.61+08:00"
    },
    {
      "vpc_id": "c08fb55d-08aa-4fa6-8053-b3",
      "region_id": "grand-cn-southwest-2",
      "status": "Available",
      "vpc_name": "vpc-default",
      "v_switch_ids": {
        "v_switch_id": [
          "6c3cebb0-258f-4f5a-b7d1"
        ]
      },
      "cidr_block": "192.168.0.0/16",
      "v_router_id": "",
      "description": "System Create default vpc",
      "is_default": true,
      "ipv6_cidr_block": "",
      "bind_ipv6_gateway": false,
      "cen_status": "",
      "route_table_id": "",
      "client_token": "",
      "updated_at": "2020-12-24T19:17:33.17+08:00",
      "created_at": "2020-11-05T11:54:50.705+08:00"
    }
  ],
  "page": 1,
  "size": 10,
  "total": 2,
  "request_id": "ScKvERiTS663pFMW"
}

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