Utilisation des expressions XPath avec le plug-in vCenter

Vous pouvez utiliser des méthodes de fonction de recherche dans le plug-in vCenter pour demander des objets d'inventaire vCenter. Vous pouvez utiliser des expressions XPath pour définir des paramètres de recherche.

Le plug-in vCenter inclut un ensemble de méthodes de fonction de recherche d'objets telles que getAllDatastores(), getAllResourcePools() et findAllForType(). Vous pouvez utiliser ces méthodes pour accéder aux inventaires des instances de vCenter connectées à votre serveur Automation Orchestrator et rechercher des objets par ID, nom ou autres propriétés.

À des fins de performances, les méthodes de recherche ne renvoient pas de propriétés pour les objets ayant été interrogés, sauf si vous spécifiez un ensemble de propriétés dans la requête de recherche.

Vous pouvez consulter une version en ligne de l'API de script pour le plug-in vCenter sur la page d'accueil de la documentation d'Orchestrator.

Important : Les requêtes basées sur des expressions XPath peuvent avoir une incidence sur les performances de Automation Orchestrator, car la méthode de recherche renvoie tous les objets d'un type donné côté vCenter et les filtres de requête sont appliqués côté plug-in vCenter.

Utilisation des expressions XPath avec des exemples du plug-in vCenter

Lorsque vous appelez une méthode de fonction de recherche, vous pouvez utiliser des expressions basées sur le langage de requête XPath. La recherche renvoie tous les objets d'inventaire qui correspondent aux expressions XPath. Si vous souhaitez interroger des propriétés, vous pouvez les inclure dans le script de recherche dans le formulaire d'un groupe de chaînes.

L'exemple Javascript suivant utilise l'objet de script VcPlugin et une expression XPath pour renvoyer les noms de tous les objets du magasin de données qui font partie des objets gérés de vCenter et qui contiennent la chaîne ds dans leur nom.

var datastores = VcPlugin.getAllDatastores(null, "xpath:name[contains(.,'ds')]");
for each (datastore in datastores){
     System.log(datastore.name); 
 }

La même expression XPath peut être appelée à l'aide de l'objet de script Server et de la méthode de fonction de recherche findAllForType.

var datastores = Server.findAllForType("VC:Datastore", "xpath:name[contains(.,'ds')]");
for each (datastore in datastores){
     System.log(datastore.name); 
 }

L'exemple de script suivant renvoie les noms de tous les objets du système hôte dont l'ID commence par le chiffre 1.

var hosts = VcPlugin.getAllHostSystems(null, "xpath:id[starts-with(.,'1')]");
for each (host in hosts){
     System.log(host.name); 
}

Le script suivant renvoie les noms et les ID de tous les objets de centre de données qui contiennent la chaîne DC, en majuscules ou minuscules, dans leur nom. Le script récupère également la propriété de balise.

var datacenters = VcPlugin.getAllDatacenters(['tag'], "xpath:name[contains(translate(., 'DC', 'dc'), 'dc')]");
for each (datacenter in datacenters){
     System.log(datacenter.name + " "  +  datacenter.id); 
}