Verwenden von XPath-Ausdrücken mit dem vCenter-Plug-In

Mithilfe der Finder-Methoden im vCenter-Plug-In können Sie Abfragen für vCenter-Bestandslistenobjekte durchführen. Sie können mithilfe von XPath-Ausdrücken Suchparameter definieren.

Das vCenter-Plug-In enthält eine Reihe von Finder-Methoden für Objekte, beispielsweise getAllDatastores(), getAllResourcePools(), findAllForType(). Mithilfe dieser Methoden können Sie auf die Bestandslisten der vCenter-Instanzen zugreifen, die mit Ihrem Automation Orchestrator-Server verbunden sind, und anhand von ID, Name oder anderen Eigenschaften nach Objekten suchen.

Aus Gründen der Leistung geben die Finder-Methoden keine Eigenschaften für die abgefragten Objekte zurück, es sei denn, Sie geben einen Satz an Eigenschaften in der Abfrage an.

Auf der Startseite der Dokumentation zu Orchestrator finden Sie eine Onlineversion der Skripterstellungs-API für das vCenter-Plug-In.

Wichtig: Die auf XPath-Ausdrücken basierenden Abfragen können die Leistung von Automation Orchestrator beeinträchtigen, da die Finder-Methode auf vCenter-Seite sämtliche Objekte eines gegebenen Typs zurückgibt und die Abfragefilter auf vCenter-Plug-In-Seite angewendet werden.

Beispiele für die Verwendung von XPath-Ausdrücken mit dem vCenter-Plug-In

Wenn Sie eine Finder-Methode aufrufen, können Sie Ausdrücke auf Basis der XPath-Abfragesprache verwenden. Die Suche gibt alle Bestandslistenobjekte zurück, die mit den XPath-Ausdrücken übereinstimmen. Wenn Sie Eigenschaften abfragen möchten, können Sie diese in Form eines Zeichenfolgen-Arrays in das Suchskript aufnehmen.

Das folgende JavaScript-Beispiel nutzt das VcPlugin-Skriptobjekt und einen XPath-Ausdruck, um die Namen aller Datenspeicherobjekte zurückzugeben, die zu den verwalteten vCenter-Objekten gehören und deren Namen die Zeichenfolge ds enthalten.

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

Derselbe XPath-Ausdruck kann mithilfe des Server-Skriptobjekts und der findAllForType-Finder-Methode aufgerufen werden.

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

Das folgende Skriptbeispiel gibt die Namen aller Hostsystemobjekte zurück, deren ID mit der Ziffer 1 beginnt.

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

Das folgende Skriptbeispiel gibt die Namen und IDs aller Datencenterobjekte zurück, deren Namen die Zeichenfolge DC in Groß- oder Kleinbuchstaben enthalten. Das Skript ruft außerdem die tag-Eigenschaft ab.

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