Guide di integrazione › Guida di riferimento dell'API di BFC › Documentazione dell'API dettagliata › Rete URIs › Recupero di una rete singola

Recupero di una rete singola

GET BFC/networks/<network base address>

Nota: la rete viene nominata in base all'indirizzo IP di base nel formato della stringa IP; in maniera specifica per la versione IP. BFC attualmente supporta le reti IPV4.

Argomenti

Nessuno.

Result

Restituisce il codice di ritorno HTTP 200 e un payload che è un record della rete in caso di completamento corretto. Restituisce un codice di errore HTTP e le informazioni di errore associate.

Description

Recupera le informazioni su una singola rete. Un record di rete restituire tali informazioni. Il record di rete contiene un elenco dei record dello spazio IP che definiscono il modo in cui l'intervallo totale di indirizzi di rete viene diviso per l'utilizzo da parte di BFC. Esiste un record dello spazio IP per ciascun utilizzo e ciascuna configurazione all'interno della configurazione di rete.

Ad esempio GET

GET BFC/network/10.10.x.x

Esempio di 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)

Esempio di payload 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": []}}