Guías de integración › Guía de referencia de la API de BFC › Documentación detallada de la API › URIs del grid › Actualización de un grid

Actualización de un grid

Se puede actualizar un grid con o sin reinicio.

Actualización de un grid sin reiniciar

PUT  BFC/grids/<grid name>

La carga útil es un registro de grid sucinto que se rellena solamente con esos campos que se van a actualizar.

Para la versión 1.0 de la API de BFC, los parámetros del grid que se pueden actualizar son:

• Descripción
• xen_config
• esx_config
• vmware_license_key
• oem_kit
• global_user_dir
• account_id
• account_key

Además, el conjunto siguiente de parámetros se puede transferir cuando no se han especificado con los parámetros anteriores. Si se requiere un reinicio para activar estos parámetros, deberá utilizar el método del grid de actualización que se describe más adelante.

• default_vlan, controller_ip, app_ips

  Consulte la tabla siguiente para conocer las combinaciones válidas de estos parámetros para la actualización.

• additional_config (se deberá especificar por sí mismo)

Result

Si el resultado es correcto, se devuelve un código 202 de HTTP y una carga útil vacía. Si el resultado es un error, se devuelve un código de error de HTTP y la información de error asociada.

Descripción

Actualiza un grid con los valores especificados. El grid de CA AppLogic® subyacente no se reinicia como parte de estas actualizaciones. Las actualizaciones del grid pasan de forma asíncrona a la llamada de actualización. Cuando una llamada GET a la URL del recurso de grid refleja los nuevos atributos del grid, la actualización se ha completado.

Nota: Para la versión 1.0 la API de BFC, al emitir una operación PUT a este URI, es un error incluir cualquiera de los parámetros de grid que se pueden actualizar por la operación de updateGridWithReboot (excepto por los valores especificados por separado en default_vlan, app_ips, controller_ip y extra_parameters).

Ejemplo de actualización del grid mediante un registro de grids con un relleno sucinto

Carga útil de 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"}

Actualización de un grid con reinicio

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

La carga útil es un registro de grid sucinto que contiene solamente esos campos que se van a actualizar.

Para la versión 1.0 de la API de BFC, los parámetros del grid que se pueden actualizar son:

• Nombre
• grid_controller_name
• recovery_password

Además, el conjunto siguiente de parámetros se puede transferir cuando no se han especificado con los parámetros anteriores. Si no se requiere un reinicio para activar estos parámetros, deberá utilizar el método del grid de actualización que descrito anteriormente.

• default_vlan, controller_ip, app_ips

  Consulte la tabla siguiente para conocer las combinaciones válidas de estos parámetros para la actualización.

• additional_config (esto se deberá especificar por sí mismo)

Result

Si el resultado es correcto, se devuelve un código 202 de HTTP y una carga útil vacía. Si el resultado es un error, se devuelve un código de error de HTTP y la información de error asociada.

Descripción

Actualiza un grid con los valores especificados y, a continuación, reinicia el grid AppLogic subyacente para hacer activos los nuevos valores. Las actualizaciones del grid pasan de forma asíncrona a la llamada de actualización. Cuando una llamada GET a la URL del recurso de grid refleja los nuevos atributos del grid, la actualización se ha completado.

Nota: Para la versión 1.0 de la API de BFC, al realizar una acción POST en este URI, es un error incluir cualquiera de los parámetros del grid que se pueden actualizar mediante PUT en el URI del recurso del grid.

Tabla. Combinación de propiedades de red para la actualización de grid