上一主题: 网格 URI下一主题: 检索网格应用 IP 范围

集成指南 › BFC API 参考指南 › 详细的 API 文档 › 网格 URI › 检索网格

检索网格

可以检索有关网格集的信息，以查找单个网格或网格状态。

GET  BFC/grids
参数

无

结果

如果成功，HTTP 返回代码 200 和显示为网格记录列表的有效负载。 如果出错，则返回 HTTP 错误代码及相关故障信息。

说明

检索系统中有关当前网格集的信息，以网格记录列表的形式显示。 对于 BFC API 的 1.0 版本，无法指定要返回的网格记录范围，会返回系统中所有网格的记录。

对于 BFC API 的 1.0 版本，grid_record 中针对 GET 填充的字段为：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 和 state。

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

示例 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}}]}

检索有关单个网格的信息

GET  BFC/grids/<grid_name>
参数

无

结果

如果成功，HTTP 返回代码 200 和显示为网格记录的有效负载。 如果出错，则返回 HTTP 错误代码及相关故障信息。

说明

检索有关单个网格的信息。 信息在网格记录中返回。 对于 BFC API 的 1.0 版本，grid_record 中针对 GET 填充的字段为：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 和 state。

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)

示例 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}}

检索单个网格的状态信息

GET  BFC/grids/<grid_name>/state
参数

无

结果

如果成功，HTTP 返回代码 200 和显示为网格状态（字符串）的有效负载。 如果出错，则返回 HTTP 错误代码及相关故障信息。

说明

检索单个网格的状态。 网格状态以字符串的形式返回。

示例 JSON 有效负载

"resource_allocated_state"