集成指南 › BFC API 参考指南 › 详细的 API 文档 › 服务器 URI › 检索单个服务器

检索单个服务器

您可以通过在 GET URI 中指定服务器的启动 MAC 地址检索有关系统中的单个服务器的信息。

GET BFC/servers/<服务器 MAC 地址>

参数

无

结果

如果成功，则返回 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": []
    }
}