Manuels d'intégration › Manuel de référence de l'API BFC › Documentation d'API détaillée › URIs de grille › Mise à jour d'une grille

Mise à jour d'une grille

Vous pouvez mettre à jour une grille avec ou sans redémarrage.

Mise à jour d'une grille sans redémarrage

PUT  BFC/grids/<grid name>

La charge utile est un enregistrement de grille sporadique qui est rempli uniquement avec les champs à mettre à jour.

Pour la version 1.0 de l'API de BFC, les paramètres pouvant être mis à jour dans les paramètres de grille sont les suivants :

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

En plus, l'ensemble suivant de paramètres peut être transmis lorsqu'aucun paramètre n'est spécifié avec les paramètres susmentionnés. Si un redémarrage est requis pour activer ces paramètres, vous devez utiliser la méthode de mise à jour de grille décrite ci-dessous.

• default_vlan, controller_ip, app_ips

  Consultez le tableau ci-dessous pour voir les combinaisons valides de ces paramètres pour la mise à jour.

• additional_config (elle doit être spécifiée de manière autonome)

Result

Code de retour HTTP 202 et une charge utile vide en cas de réussite. Renvoie un code d'erreur HTTP et les informations de panne associées concernant l'erreur.

Description

Met à jour une grille avec les valeurs spécifiées. La grille CA AppLogic® sous-jacente n'est pas relancée dans le cadre de ces mises à jour. Les mises à jour de grille parviennent de façon asynchrone à l'appel de mise à jour. Lorsqu'un appel GET à l'URL de ressource de grille reprend les nouveaux attributs de la grille, la mise à jour a été terminée.

Remarque : Pour la version 1.0 de l'API BFC, lorsqu'une commande PUT est exécutée sur cet URI, il convient de ne pas inclure les paramètres de grille qui peuvent être mis à jour par l'opération updateGridWithReboot (à l'exception des paramètres default_vlan, app_ips, controller_ip et extra_parameters qui sont spécifiés séparément).

Exemple de mise à jour d'une grille à l'aide d'un enregistrement de grille rempli de façon sporadique

Charge utile 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"}

Mise à jour d'une grille avec redémarrage

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

La charge utile est un enregistrement de grille rempli de façon sporadique et contenant uniquement les champs à mettre à jour.

Pour la version 1.0 de l'API de BFC, les paramètres pouvant être mis à jour dans les paramètres de grille sont les suivants :

• name
• grid_controller_name
• recovery_password

En plus, l'ensemble suivant de paramètres peut être transmis lorsqu'aucun paramètre n'est spécifié avec les paramètres susmentionnés. Si aucun redémarrage n'est requis pour activer ces paramètres, vous devez utiliser la méthode de mise à jour de grille décrite ci-dessus.

• default_vlan, controller_ip, app_ips

  Consultez le tableau ci-dessous pour voir les combinaisons valides de ces paramètres pour la mise à jour.

• additional_config (doit être spécifié de manière autonome)

Result

Code de retour HTTP 202 et une charge utile vide en cas de réussite. Renvoie un code d'erreur HTTP et les informations de panne associées concernant l'erreur.

Description

Met à jour une grille avec les valeurs spécifiées, puis redémarre la grille AppLogic sous-jacente pour activer les nouvelles valeurs. Les mises à jour de grille parviennent de façon asynchrone à l'appel de mise à jour. Lorsqu'un appel GET à l'URL de ressource de grille reprend les nouveaux attributs de la grille, la mise à jour a été terminée.

Remarque : Pour la version 1.0 de l'API BFC, lorsqu'une commande POST est exécutée sur cet URI, il convient de ne pas inclure les paramètres de grille qui peuvent être mis à jour par l'exécution d'une commande PUT sur l'URI de ressource de grille.

Tableau - Combinaisons de propriétés de réseau possibles pour la mise à jour de la grille