Manuels d'intégration › Manuel de référence de l'API BFC › Documentation d'API détaillée › Server URIs (Adresse IP du serveur) › Récupération d'un serveur unique

Récupération d'un serveur unique

Vous pouvez récupérer des informations relatives à un serveur unique dans le système en spécifiant l'adresse MAC de démarrage du serveur dans l'URI GET.

GET BFC/servers/<adresse_MAC_serveur>

Arguments

Aucun

Result

Renvoie le code de retour HTTP 200 et une charge utile correspondant à un enregistrement de serveur 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 des informations sur un serveur unique dans le système. Les informations sont renvoyées dans un enregistrement de serveur.

Exemple d'opération GET

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

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

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