グリッドの取得

統合ガイド › Backbone Fabric Controller （BFC） API リファレンスガイド › API に関する詳細なドキュメント › グリッドの取得

グリッドの取得

グリッドのセット、単一のグリッド、およびグリッドの状態に関する情報を取得できます。

グリッドのセットに関する情報を取得するには、以下を実行します。

GET  BFC/grids

ペイロードは空です。

結果

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

説明

システム内の現在のグリッドのセットに関する情報を、グリッドレコードのリストとして取得します。 BFC API の 1.0 リリースの場合は、返すグリッドレコードの範囲を指定できません。システム内のすべてのグリッドに対してレコードが返されます。

BFC API の 1.0 リリースの場合、GET で入力される grid_record 内のフィールドは、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 です。

例

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 リリースの場合、GET で入力される grid_record 内のフィールドは、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 です。

例：

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"