Rubrique précédente: URIs de grilleRubrique suivante: Récupération des plages d'adresses IP d'application de grille


Récupération des grilles

Vous pouvez récupérer des informations sur un ensemble de grilles, pour une grille unique et pour l'état de la grille.

GET  BFC/grids
Arguments

Aucun

Result

Code de retour HTTP 200 et une charge utile correspondant à une liste d'enregistrements de grille 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 relatives à l'ensemble actuel de grilles dans le système sous la forme d'une liste d'enregistrements de grilles. Pour la version 1.0 de l'API de BFC, vous ne pouvez pas spécifier la plage d'enregistrements de grille à retourner, les enregistrements sont renvoyés pour toutes les grilles du système.

Pour la version 1.0 de l'API BFC, les champs de grid_record qui sont remplis lors d'une action GET sont les suivants : name, description, controller_ip, id, applogic_version, xen_config, esx_config, external_network, default_vlan, vmware_license_key, app_ip_count, app_ips, servers, oem_kit, global_user_dir, account_id et state.

Exemple Python

session = get_session()
conn = HTTPSConnection(bfcHost + ':8443')
conn.connect()
conn.request(method='GET',
             url='/BFC/grids',
             headers={'Content-Type':'application/json',
                      'Authorization':session})
grids = json.loads(conn.getresponse().read())
print grids

Exemple de charge utile JSON

{"grid":{"comp_id":1234,"id":2,"name":"SimpleGrid2", 
"description":"SimpleGrid2 description","state":"resource_allocated_state", 
"applogic_version":"3.1.2","applogic_hotfixes":null,"enable_language_packs":false, 
"xen_config":{"grid_server_configuration":{"min":2,"target":2,"max":2,"selection_criteria":null}}, 
"esx_config":{"grid_server_configuration":{"min":2,"target":2,"max":2,"selection_criteria":null}}, 
"servers":[],"external_network":"127.10.10.0/24", 
"app_ips":[{"grid_ip_range":{subnet_id:2345,vlan:10,public_private:"public", 
ip_low:"127.10.10.2",ip_high:"127.10.10.11"}],"app_ip_count":10, 
"controller_ip":"127.10.10.1","default_vlan":1, 
"account_id":null,"account_key":null, oem_kit":null, 
"vmware_license_key":"XXXXX-XXXXX-XXXXX-XXXXX-XXXXX","global_user_dir":null,
"grid_controller_name":null,"grid_controller_user":null,"grid_controller_password":null, 
"recovery_password":null,"additional_config":null}},
{"grid":{"comp_id":5678,"id":1,"name":"SimpleGrid1", 
"description":"SimpleGrid1 description","state":"resource_allocated_state", 
"applogic_version":"3.1.1","applogic_hotfixes":null,"enable_language_packs":false, 
"xen_config":{"grid_server_configuration":{"min":2,"target":2,"max":2,"selection_criteria":null}}, 
"esx_config":{"grid_server_configuration":{"min":0,"target":0,"max":0,"selection_criteria":null}}, 
"servers":[],"external_network":"127.10.10.0/24", 
"app_ips":[{"grid_ip_range":{subnet_id:1245,vlan:null,public_private:"public", 
ip_low:"127.10.10.13",ip_high:"127.10.10.22"}],"app_ip_count":10, 
"controller_ip":"127.10.10.12","default_vlan":1, 
"account_id":null,"account_key":null, oem_kit":null, 
"vmware_license_key":"XXXXX-XXXXX-XXXXX-XXXXX-XXXXX","global_user_dir":null, 
"grid_controller_name":null,"grid_controller_user":null,"grid_controller_password":null, 
"recovery_password":null, "additional_config":null, "external_storage":null}}]} 

Récupération d'informations relatives à une seule grille

GET  BFC/grids/<grid_name>
Arguments

Aucun

Result

Code de retour HTTP 200 et une charge utile correspondant à un enregistrement de grille 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 à une seule grille. Les informations sont renvoyées dans un enregistrement de grille. Pour la version 1.0 de l'API BFC, les champs de grid_record qui sont remplis lors d'une action GET sont les suivants : name, description, controller_ip, id, applogic_version, xen_config, esx_config, external_network, default_vlan, vmware_license_key, app_ip_count, app_ips, servers, oem_kit, account_id, global_user_dir, external_storage et state.

Exemple Python

from httplib import HTTPSConnection
import json
import os
import sys

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

Exemple de charge utile JSON

{"grid":{"comp_id":null,"id":2,"name":"SimpleGrid2", 
"description":"SimpleGrid2 description","state":"resource_allocated_state", 
"applogic_version":"3.1.2","applogic_hotfixes":null,"enable_language_packs":false, 
"xen_config":{"grid_server_configuration":{"min":2,"target":2,"max":2,"selection_criteria":[["xengold"]]}}, 
"esx_config":{"grid_server_configuration":{"min":2,"target":2,"max":2,"selection_criteria":[["esxgold"]]}}, 
"servers":[],"external_network":"127.10.10.0/24", 
"app_ips":[{"grid_ip_range":{subnet_id:2345,vlan:10,public_private:"public", 
ip_low:"127.10.10.2",ip_high:"127.10.10.11"}],"app_ip_count":10, 
"controller_ip":"127.10.10.1","default_vlan":1, 
"account_id":null,"account_key":null, "oem_kit":"Acme Computer Corp", 
"vmware_license_key":"XXXXX-XXXXX-XXXXX-XXXXX-XXXXX","global_user_dir":null, 
"grid_controller_name":null,"grid_controller_user":null,"grid_controller_password":null, 
"recovery_password":null,"additional_config":null,"external_storage":null}} 

Récupération d'informations d'état pour une seule grille

GET  BFC/grids/<grid_name>/state
Arguments

Aucun

Result

Code de retour HTTP 200 et une charge utile qui correspond à l'état de la grille présenté sous forme de chaîne 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 l'état d'une seule grille. L'état de la grille est renvoyé dans une chaîne.

Exemple de charge utile JSON

"resource_allocated_state"