集成指南 › BFC API 参考指南 › 详细的 API 文档 › 网络 URI › 检索单个网络

检索单个网络

GET BFC/networks/<network base address>

注意：网络采用 IP 字符串格式由其基础 IP 地址命名；IP 版本所特有。 BFC 当前支持 IPV4 网络。

参数

无。

结果

如果成功，则返回 HTTP 返回代码 200 和为网格记录的有效负载。 如果出错，则返回 HTTP 错误代码及相关故障信息。

说明

检索有关单个网络的信息。 此信息通过一条网络记录返回。 网络记录包含 IP 空间记录的列表，这些空间记录定义如何划分总网络地址空间，以供 BFC 使用。 IP 空间记录为网络配置中的每个用法和 VLAN 组合而存在。

GET 示例

GET BFC/network/10.10.x.x

Python 示例

from httplib import HTTPSConnection
import json
import os
import sys

networkMac = sys.argv[1]
bfcHost = os.environ["BFC_HOST"]
bfcSession = os.environ["BFC_SESSION"]
conn = HTTPSConnection(bfcHost + ':8443')
conn.connect()
conn.request(method='GET',
             url='/BFC/networks' + 'networkMac',
             headers={'Content-Type':'application/json',
                      'Authorization':bfcSession})
r1 = conn.getresponse()
print 'HTTP Response Code: {0}'.format(r1.status)
servers = json.loads(r1.read())
print json.dumps(servers, sort_keys=True, indent=4)

示例 JSON 有效负载

{"network": {
        "address_space": {
            "ip_space": {
                "address_pools": [
                    {"ip_pool": {
                            "available_ranges": [
                                {"ip_range": {
                                        "end_address": "10.10.75.11",
                                        "size": 10,
                                        "start_address": "10.10.75.2"}}],
                            "num_addresses": 11,
                            "num_available": 10,
                            "num_used": 1,
                            "ranges": [
                                {"ip_range": {
                                        "end_address": "10.10.75.12",
                                        "size": 11,
                                        "start_address": "10.10.75.2"}}],
                            "type": "hardware",
                            "used_ranges": [
                                {"ip_range": {
                                        "end_address": "10.10.75.12",
                                        "size": 1,
                                        "start_address": "10.10.75.12"}}]}},
                    {"ip_pool": {
                            "available_ranges": [],
                            "num_addresses": 4,
                            "num_available": 0,
                            "num_used": 4,
                            "ranges": [
                                {"ip_range": {
                                        "end_address": "10.10.75.117",
                                        "size": 4,
                                        "start_address": "10.10.75.114"}}],
                            "type": "application",
                            "used_ranges": [
                                {"ip_range": {
                                        "end_address": "10.10.75.117",
                                        "size": 4,
                                        "start_address": "10.10.75.114"}}]}}],
                "available_ranges": [[
                        {"ip_range": {
                                "end_address": "10.10.75.254",
                                "size": 137,
                                "start_address": "10.10.75.118"}},
                        {"ip_range": {
                                "end_address": "10.10.75.113",
                                "size": 101,
                                "start_address": "10.10.75.13"}}],238]}},
        "base_address": "10.10.75.0",
        "cidr": 24,
        "comp_id":1450,
        "gateway_addresses": [
            "10.10.75.1"],
        "ip_version": "ipv4",
        "usages": [
            "bbc/applogic_external_network"],
        "vlan_address_spaces": []}}