統合ガイド › BFC API リファレンス ガイド › API に関する詳細なドキュメント › ネットワーク URI › 単一ネットワークの取得

単一ネットワークの取得

GET BFC/networks/<network base address>

注： ネットワークは IP 文字列形式でそのベース IP アドレスにより命名されます。IP バージョンに固有です。 現在、BFC は IPV4 ネットワークをサポートします。

引数

なし。

結果

成功時に、HTTP リターン コード 200 とネットワーク レコードであるペイロードが返されます。 エラーの際には、HTTP エラー コードと、関連するエラー情報が返されます。

説明

単一のネットワークに関する情報を取得します。 ネットワーク レコードによりこの情報が返されます。 ネットワーク レコードには、合計のネットワーク アドレス空間が BFC 使用のために分割される方法を定義する IP スペース レコードのリストが含まれます。 IP Space レコードはネットワーク設定内の各使用状況と 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": []}}