Integrationshandbücher › BFC API-Referenzhandbuch › Detaillierte API-Dokumentation › Netzwerk-URIs › Abrufen eines einzelnen Netzwerks

Abrufen eines einzelnen Netzwerks

GET BFC/networks/<network base address>

Hinweis: Das Netzwerk wird nach der Basis-IP-Adresse im IP-Zeichenfolgenformat benannt, spezifisch für die IP-Version. Der BFC unterstützt derzeit IPV4-Netzwerke.

Argument

Kein(e).

Result

Gibt den HTTP-Rückgabecode 200 und eine Nutzlast zurück, die einen erfolgreichen Netzwerkdatensatz darstellt. Gibt einen HTTP-Fehlercode und die zugehörigen Fehlerinformationen zurück.

Description

Ruft Informationen zu einem einzelnen Netzwerk ab. Ein Netzwerkdatensatz gibt diese Informationen zurück. Der Netzwerkdatensatz enthält eine Liste der IP-Bereichsdatensätzen, die angeben, wie der gesamte Netzwerkadressbereich für die BFC-Verwendung verteilt ist. Ein IP-Bereichsdatensatz ist für jede Verwendung und für die VLAN-Kombination innerhalb der Netzwerkkonfiguration vorhanden.

Beispiel: GET

GET BFC/network/10.10.x.x

Beispiel für 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)

Beispiel-JSON-Nutzlast

{"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": []}}