子网 REST API

使用该 REST API 查看子网。

使用“创建新子网用例”来创建新子网,使用“删除子网用例”来删除子网。 有关更多信息,请参阅 创建新子网删除子网

获取所有子网

表 1. 获取所有子网
REST API 信息 描述
URI /admin/resources/subnets  
方法 (method) GET  
返回 200 返回所有子网的列表。
404 未找到子网列表。
500 平台 System Manager 在处理请求时迂到内部错误。

创建所有子网的列表。

可使用可选参数来修改来自 REST API 调用的响应。 有关更多信息,请参阅“相关信息”部分。

响应主体

{
      "bandwidth": null,
      "created_time": "Fri 28 Aug 2015 12:52:57.594 UTC",
      "created_time_raw": 1440766377594,
      "description": null,
      "dns": "172.17.248.101",
      "gateway": "172.20.56.1",
      "id": "/admin/resources/subnets/b3bc8e6a-8df4-41b8-8fdb-45a4661c70af",
      "ip_version": "ipv4",
      "label_key": "purexxxx",
      "management": "F",
      "mask": "255.255.248.0",
      "name": "Shared",
      "purpose": "data",
      "routes": [
      ],
      "secondary_dns": "",
      "state": "available",
      "subnet": "172.20.56.0",
      "updated_time": "Fri 12 Aug 2016 20:06:07.525 UTC",
      "updated_time_raw": 1471032367525,
      "vdc": "/admin/resources/vdcs/92c626da-a2cd-4f9a-b36b-b0349fa6cc0e",
      "vlan_id": "1824"
   }
]
带宽 (bandwidth)
以兆位表示的该子网速度。 这是可选属性。 目前不使用。
dns
此子网的主 DNS 服务器。 这是可选属性。
secondary_dns
此子网的辅助 DNS 服务器。 这是可选属性。
网关 (gateway)
此子网的网关地址。 这是可选属性。
ip_version
用于此子网的 IP 版本。 允许的值为 ipv4ipv6。 这是可选属性。
掩码 (mask)
此子网的子网掩码。 这是可选属性。
子网
包含 IP 地址和相关逻辑资源(例如,DNS 和缺省网关)的 TCP/IP 子网。 这是可选属性。
vdc
对该子网的 VDC 的引用。 这是可选属性。
state
缺省情况下,创建新子网时,其状态将设置为 unavailable。 如果在子网中创建了新地址或地址范围(或列表),其状态将自动转变为 available。 当从子网中移除最后一个地址时,其状态恢复为 unavailable
vlan_id
该值为必需,并且必须与 network_type customer 预定义网络之一的 VLAN 匹配。

获取特定子网

表 2. 获取特定子网
REST API 信息 描述
URI /admin/resources/subnet/{id}  
方法 (method) GET  
返回 200 返回了子网标识。
404 未找到子网标识。
500 平台 System Manager 在处理请求时迂到内部错误。