Guide di integrazione › Guida di riferimento dell'API di BFC › Documentazione dell'API dettagliata › URIs della griglia › Aggiornamento di una griglia

Aggiornamento di una griglia

È possibile aggiornare una griglia con o senza riavvio.

Aggiornamento di una griglia senza riavvio

PUT  BFC/grids/<grid name>

Il payload è un record della griglia sparse che viene popolato solo con i campi da aggiornare.

Per la versione 1.0 dell'API di BFC, i parametri della griglia che è possibile aggiornare sono:

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

Inoltre, è possibile trasmettere il seguente set di parametri, se non specificato con i suddetti parametri. Se è necessario un riavvio per abilitare tali parametri, utilizzare il metodo di aggiornamento della griglia descritto di seguito.

• default_vlan, controller_ip, app_ips

  Consultare la tabella seguente per le combinazioni valide di tali parametri per l'aggiornamento.

• additional_config (deve essere specificato da sé)

Result

Codice di ritorno HTTP 202 e un payload vuoto in caso di completamento corretto dell'operazione. Restituisce un codice di errore HTTP e le informazioni di errore associate.

Description

Aggiorna una griglia con i valori specificati. La griglia di CA AppLogic® sottostante non viene riavviata come parte di questi aggiornamenti. Gli aggiornamenti della griglia avvengono asincronamente rispetto alla chiamata di aggiornamento. Quando una chiamata GET all'URL della risorsa della griglia riflette i nuovi attributi della griglia stessa, l'aggiornamento è stato completato.

Nota: per la versione 1.0 dell'API di BFC, quando si trasmette un PUT a tale URL, non si deve includere uno qualsiasi dei parametri della griglia che è possibile aggiornare mediante l'operazione updateGridWithReboot (tranne nel caso dei parametri specificati separatamente default_vlan, app_ips, controller_ip e extra_parameters).

Esempio di aggiornamento della griglia mediante un record della griglia popolato in modo sparse

Payload JSON:

	{"griglia":
		"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"}

Aggiornamento di una griglia con riavvio

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

Il payload è un record della griglia popolato in modo sparse che contiene solo i campi da aggiornare.

Per la versione 1.0 dell'API di BFC, i parametri della griglia che è possibile aggiornare sono:

• name
• grid_controller_name
• recovery_password

Inoltre, è possibile trasmettere il seguente set di parametri, se non specificato con i suddetti parametri. Se non è necessario un riavvio per abilitare tali parametri, utilizzare il metodo di aggiornamento della griglia descritto in precedenza.

• default_vlan, controller_ip, app_ips

  Consultare la tabella seguente per le combinazioni valide di tali parametri per l'aggiornamento.

• additional_config (deve essere specificato da sé)

Result

Codice di ritorno HTTP 202 e un payload vuoto in caso di completamento corretto dell'operazione. Restituisce un codice di errore HTTP e le informazioni di errore associate.

Description

Aggiorna una griglia con i valori specificati, quindi riavvia la griglia di AppLogic sottostante per rendere attivi i nuovi valori. Gli aggiornamenti della griglia avvengono asincronamente rispetto alla chiamata di aggiornamento. Quando una chiamata GET all'URL della risorsa della griglia riflette i nuovi attributi della griglia stessa, l'aggiornamento è stato completato.

Nota: per la versione 1.0 dell'API di BFC, quando si trasmette un POST a tale URI, non si deve includere nessuno dei parametri della griglia che è possibile aggiornare mediante un PUT all'URI della risorsa della griglia.

Tabella - Combinazione delle proprietà di rete per l'aggiornamento della griglia