Manuels d'intégration › Manuel de référence de l'API BFC › Documentation d'API détaillée › URIs du réseau › Récupération d'un réseau unique

Récupération d'un réseau unique

GET BFC/networks/<adresse_base_réseau>

Remarque : Le réseau est nommé par son adresse IP de base au format de chaîne IP, propre à la version IP. BFC prend actuellement en charge les réseaux IPV4.

Arguments

aucun

Result

Renvoie le code de retour HTTP 200 et une charge utile correspondant à un enregistrement de réseau en cas de réussite. Renvoie un code d'erreur HTTP et les informations de panne associées concernant l'erreur.

Description

Récupère les informations relatives à un seul réseau. Un enregistrement de réseau renvoie ces informations. L'enregistrement de réseau contient une liste d'enregistrements d'espace d'adresses IP qui définissent la répartition de l'espace d'adressage réseau total utilisé par BFC. Un enregistrement d'espace d'adresses IP existe pour chaque utilisation et combinaison de VLAN dans la configuration réseau.

Exemple d'opération GET

GET BFC/network/10.10.x.x

Exemple 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)

Exemple de charge utile 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": []}}