集成指南 › Backbone Fabric Controller (BFC) API 参考指南 › 详细的 API 文档 › 网格更新

网格更新

可以在重新启动或不重新启动的情况下更新网格。

在不重新启动的情况下更新网格

PUT  BFC/grids/<grid name>

有效负载是仅包含要更新的字段的稀疏网格记录。

对于 BFC API 的 1.0 版本，网格参数中可以更新的参数为：

• description
• xen_config
• esx_config
• vmware_license_key
• oem_kit
• global_user_dir
• account_id
• account_key

此外，当未使用以上参数指定时，可以传递以下参数集。 如果需要重新启动才能启用这些参数，则应使用下述的更新网格方法。

• default_vlan, controller_ip, app_ips

  有关用于更新的这些参数的有效组合，请参阅下表。

• additional_config（必须由其自身指定）

结果

如果成功，HTTP 返回代码 202 和空有效负载。 如果出错，则返回 HTTP 错误代码及相关故障信息。

说明

使用指定的值更新网格。 在这些更新过程中，不会重新启动基础 CA AppLogic 网格。 网格更新对于更新调用异步进行。 当对网格资源 URL 的 GET 调用反映网格的新属性时，更新即已完成。

注意：对于 BFC API 的 1.0 版本，对该 URI 发出 PUT 时，包含任何可以由 updateGridWithReboot 操作更新的网格参数是错误的（单独指定的 default_vlan、app_ips、controller_ip 和 extra_parameters 除外）。

使用稀疏填充的网格记录的网格更新示例

JSON 有效负载：

	{"grid":
		"description":"Updated SimpleGrid1 description",
		"oem_kit":"ACME Computer Corp", 
		"xen_config":
		  {"grid_server_configuration":{"min":3,"target":3,"max":3,
		  "selection_criteria":null}},
		"esx_config":
		 ("grid_server_configuration":{"min":1,"target":1,"max":1,
		  "selection_criteria":null}},
		"vmware_license_key":"XXXXX-XXXXX-XXXXX-XXXXX-XXXXX"}

在重新启动的情况下更新网格

POST  BFC/grids/<grid name>/operations/updateGridWithReboot

有效负载是仅包含要更新字段的稀疏填充网格记录。

对于 BFC API 的 1.0 版本，网格参数中可以更新的参数为：

• 名称
• grid_controller_name
• recovery_password

此外，当未使用以上参数指定时，可以传递以下参数集。 如果不需要重新启动就可以启用这些参数，则应使用前面所述的更新网格方法。

• default_vlan, controller_ip, app_ips

  有关用于更新的这些参数的有效组合，请参阅下表。

• additional_config（必须由其自身指定）

结果

如果成功，HTTP 返回代码 202 和空有效负载。 如果出错，则返回 HTTP 错误代码及相关故障信息。

说明

使用指定的值更新网格，然后重新启动基础 AppLogic 网格使新值生效。 网格更新对于更新调用异步进行。 当对网格资源 URL 的 GET 调用反映网格的新属性时，更新即已完成。

注意：对于 BFC API 的 1.0 版本，对该 URI 发出 POST 时，包含任何可以通过对网格资源 URI 执行 PUT 操作进行更新的网格参数是错误的。

表－用于网格更新的网络属性组合