XtremIO : premiers pas avec l’interface RESTful

On continue notre exploration “post PoC” de nos futures appliances XtremIO (les deux sont arrivées ! MOM en cours de préparation ;) ). En dehors de l’outil de supervision déjà longuement présenté dans de précédents billets, je vous propose un parcours rapide de l’interface REST d’XtremIO. Tout comme VPlex, l’AFA d’EMC est donc capable d’être interrogée et même pilotée à travers une interface dite RESTful. Le principe est désormais très répandu dans le monde de l’automatisme informatique : vous envoyez un ordre via une requête http à la baie (ou la console de gestion) et en retour vous récupérez un contenu de type json correspondant au résultat (données demandées ou résultat d’une commande).

Dans la pratique, ce type d’interface est particulièrement simple à utiliser, dans le sens ou un banal WGET ou CURL vous permet, moyennant le respect de la syntaxe de construction de l’URL correspondant à l’équipement interrogé, d’effecteur la majorité des opérations normalement accessibles via l’interface d’administration.

Pour XtremIO, la syntaxe est très claire et précise. L’url de base est construite de cette manière :
https://username:password@fqdn/api/json/ ......

Ici, username et password représentent votre user de connexion (identique à celui utilisé pour administrer la baie via l’interface graphique), fqdn représentant l’IP ou le hostname de la management station d’XtremIO.

Par exemple, pour récupérer les différents objets que comprend l’interface RESTful :

On continue : pour récupérer la liste des volumes actuellement créés dans l’appliance :

Vous noterez que l’appliance dispose donc d’un seul volume actuellement provisionné : “vplex_rdm_testxio0”. Vous pouvez avoir tous les détails sur ce volume, bien entendu :

En matière d’administration, il est également possible de donner des ordres à la baie. Pour ce faire, il ne faut plus utiliser le HTTP GET classique mais le POST. La commande est plus complexe à construire, dans le sens ou il faut envoyer un contenu spécifiquement formatté pour réaliser l’opération, contrairement à l’interrogation ou seule l’URL de la requête suffit à préciser ce que l’on souhaite récupérer.

Pour pouvoir tester cela, il suffit de créer un petit fichier contenant, en format “json”, les paramètres souhaités pour la commande puis de l’envoyer via une commande curl “POST”. Par exemple, pour créer un nouveau volume sur la baie, voici le contenu du fichier :

Ensuite, déclenche un curl “POST” avec le fichier (ici “createvol.txt”) :

C’est terminé, la commande retour indique que le volume a été créé avec l’id interne “1”, que l’on peut interroger ensuite pour confirmer ses caractéristiques.

XtremIO dispose donc d’une interface RESTful très ouverte et complète, permettant d’envisager tous les usages en matière de supervision et administration. Nous allons travailler de notre coté à l’intégration de nos appliances XtremIO à notre outil de supervision Nagios, comme nous l’avions fait pour VPlex lors de son implantation. Dès que ce sera mûr et en production chez nous, je vous mettrai à disposition les différents scripts associés.