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

単一サーバの取得

システムの単一サーバに関する情報を取得できます。その場合、GET URI でサーバのブート MAC アドレスを指定します。

GET BFC/servers/<server MAC address>

引数

なし

結果

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

説明

システムの単一サーバに関する情報を取得します。 情報はサーバ レコードで返されます。

GET の例

GET  BFC/servers/00:01:02:03:04:05

Python の例

from httplib import HTTPSConnection
import json
import os
import sys

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

JSON ペイロードの例

{
    "server": {
        "comp_id": 1575,
        "description": [],
        "discovery_time": 1349136000000,
        "grid_info": {
            "grid_info": {
                "category": null,
                "comp_id": 1603,
                "message": "Waiting for grid cleanup",
                "name": "mygrid",
                "state": "resource_booting_state",
                "uri": "BFC/grids/mygrid"
            }
        },
        "grid_os_info": {
            "grid_os_info": {
                "applogic_server_enabled": false,
                "applogic_server_name": null,
                "applogic_server_state": "creating_grid",
                "category": "Compute Host Power Status",
                "comp_id": 1628,
                "has_grid_controller": false,
                "hypervisor_type": "Xen",
                "message": "Compute host is currently under active power control.",
                "state": "resource_running_state"
            }
        },
        "ignore_power_controllers_during_inventory": false,
        "inventory": {
            "inventory": {
                "cpu_cores": 4,
                "cpu_speed": 3.0,
                "disk_count": 1,
                "disks": [
                    {
                        "disk": {
                            "name": "/dev/sda",
                            "size": 146.81302271999999
                        }
                    }
                ],
                "inventory_time": 1349136000000,
                "memory_size": 4.0,
                "network_interfaces": [
                    {
                        "network_interface": {
                            "connectivity": [
                                "backbone"
                            ],
                            "ip_address": "192.168.X.X",
                            "is_boot": true,
                            "mac_address": "00:01:02:03:04:05",
                            "name": "eth0",
                            "speed": 1000
                        }
                    },
                    {
                        "network_interface": {
                            "connectivity": [
                                "external"
                            ],
                            "ip_address": "10.10.X.X",
                            "is_boot": false,
                            "mac_address": "01:02:03:04:05:06",
                            "name": "eth1",
                            "speed": 1000
                        }
                    }
                ],
                "power_controllers": [
                    {
                        "power_controller": {
                            "comp_id": 1592,
                            "credential_mode": "system_configured",
                            "credential_set_time": 1349226625437.5129,
                            "ip_address": "10.10.X.X",
                            "mac_address": "02:03:04:05:06:07",
                            "power_status": "on",
                            "type": "controlled",
                            "user_number": 3,
                            "username": "PowerAdmin__BFC"
                        }
                    }
                ],
                "total_disk_space": 146.81302271999999
            }
        },
        "inventorying": false,
        "mac_address": "00:01:02:03:04:05",
        "power_ip_address": "10.10.X.X",
        "power_mode": "controlled",
        "power_status": "on",
        "server_info": {
            "server_info": {
                "category": "Compute Host Power Status",
                "message": "Compute host is currently under active power control.",
                "state": "resource_running_state",
                "uri": "BFC/servers/00:01:02:03:04:05"
            }
        },
        "tags": []
    }
}