Integrationshandbücher › BFC API-Referenzhandbuch › Detaillierte API-Dokumentation › Grid-URIs › Aktualisieren eines Grid

Aktualisieren eines Grid

Sie können ein Grid mit oder ohne Neustart aktualisieren.

Grid ohne Neustart aktualisieren

PUT  BFC/grids/<grid name>

Die Nutzlast ist ein Grid-Datensatz geringen Umfangs, der nur mit den Feldern ausgefüllt wird, die aktualisiert werden sollen.

Bei der 1.0-Version der BFC-API lauten die zu aktualisierenden Parameter in den Grid-Parametern folgendermaßen:

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

Außerdem kann der folgende Parametersatz übergeben werden, wenn dieser bei den obigen Parametern nicht angegeben wird. Wenn ein Neustart erforderlich ist, um diese Parameter zu aktivieren, sollten Sie die unten beschriebene Methode zum Aktualisieren des Grid verwenden.

• default_vlan, controller_ip, app_ips

  In der nachfolgenden Tabelle finden Sie gültige Kombinationen dieser Parameter für die Aktualisierung.

• additional_config (muss von selbst angegeben werden)

Result

HTTP-Rückgabecode 202 und ein leere Nutzlast bei Erfolg. Gibt einen HTTP-Fehlercode und die zugehörigen Fehlerinformationen zurück.

Description

Aktualisiert ein Grid mit den angegebenen Werten. Das zugrunde liegende CA AppLogic®-Grid wird nicht als Teil dieser Aktualisierungen neu gestartet. Grid-Aktualisierungen erfolgen asynchron zum Aktualisierungsaufruf. Wenn ein Aufruf-Befehl für die ULR der Grid-Ressource die neuen Attribute des Grid widerspiegelt, ist die Aktualisierung abgeschlossen.

Hinweis: Wenn bei der 1.0-Version der BFC-API ein Befehl zum Speichern für diese URI ausgegeben wird, ist es unzulässig, einen der Grid-Parameter einzubeziehen, die mit dem Vorgang "updateGridWithReboot" aktualisiert werden können (mit Ausnahme der separat angegebenen Parameter "default_vlan", "app_ips", "controller_ip" und "extra_parameters").

Beispiel für die Grid-Aktualisierung mithilfe eines kaum ausgefüllten Grid-Datensatzes

JSON-Nutzlast:

	{"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}},
		("grid_server_configuration":{"min":1,"target":1,"max":1,

Grid mit Neustart aktualisieren

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

Die Nutzlast ist ein kaum ausgefüllter Grid-Datensatz, der nur die zu aktualisierenden Felder enthält.

Bei der 1.0-Version der BFC-API lauten die zu aktualisierenden Parameter in den Grid-Parametern folgendermaßen:

• Name
• grid_controller_name
• recovery_password

Außerdem kann der folgende Parametersatz übergeben werden, wenn dieser bei den obigen Parametern nicht angegeben wird. Wenn ein Neustart erforderlich ist, um diese Parameter zu aktivieren, sollten Sie die oben beschriebene Methode zum Aktualisieren des Grid verwenden.

• default_vlan, controller_ip, app_ips

  In der nachfolgenden Tabelle finden Sie gültige Kombinationen dieser Parameter für die Aktualisierung.

• additional_config (dies muss von selbst angegeben werden)

Result

HTTP-Rückgabecode 202 und ein leere Nutzlast bei Erfolg. Gibt einen HTTP-Fehlercode und die zugehörigen Fehlerinformationen zurück.

Description

Aktualisiert ein Grid mit den angegebenen Werten und startet dann das zugrunde liegende AppLogic-Grid neu, um die neuen Werte zu aktivieren. Grid-Aktualisierungen erfolgen asynchron zum Aktualisierungsaufruf. Wenn ein Aufruf-Befehl für die ULR der Grid-Ressource die neuen Attribute des Grid widerspiegelt, ist die Aktualisierung abgeschlossen.

Hinweis: Wenn bei der 1.0-Version der BFC-API ein POST-Befehl für diese URI ausgegeben wird, ist es unzulässig, einen der Grid-Parameter einzubeziehen, die mithilfe eines Befehls zum Speichern der URI der Grid-Ressource aktualisiert werden können.

Tabelle - Kombination der Netzwerkeigenschaften für die Grid-Aktualisierung