Usar expresiones XPath con el complemento vCenter

Puede utilizar los métodos de buscador en el complemento vCenter para consultar los objetos de inventario de vCenter. Las expresiones XPath permiten definir parámetros de búsqueda.

El complemento vCenter incluye un conjunto de métodos de buscador de objetos, como getAllDatastores(), getAllResourcePools() o findAllForType(). Puede utilizar estos métodos para acceder a los inventarios de las instancias de vCenter que están conectadas al servidor de Automation Orchestrator y buscar objetos por ID, nombre u otras propiedades.

Por motivos de rendimiento, los métodos de buscador no devuelven las propiedades de los objetos consultados a menos que especifique un conjunto de propiedades en la consulta de búsqueda.

Puede consultar una versión en línea de la API de creación de scripts para el complemento vCenter en la página de inicio de la documentación de Orchestrator.

Importante: Las consultas basadas en expresiones XPath podrían afectar al rendimiento de Automation Orchestrator porque el método de buscador devuelve todos los objetos de un tipo específico en el lado de vCenter y los filtros de consulta se aplican en el lado del complemento vCenter.

Ejemplos para usar expresiones XPath con el complemento de vCenter

Cuando invoca un método de buscador, puede utilizar expresiones basadas en el lenguaje de consulta XPath. La búsqueda devuelve todos los objetos de inventario que coinciden con las expresiones XPath. Si desea consultar alguna de las propiedades, puede incluirlas en el script de búsqueda en forma de matriz de cadena.

El ejemplo de JavaScript siguiente utiliza el objeto de creación de scripts VcPlugin y una expresión XPath para devolver los nombres de todos los objetos de base de datos que forman parte de los objetos administrados de vCenter y que contienen la cadena ds en el nombre.

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

La misma expresión XPath se puede invocar mediante el objeto de creación de scripts Server y el método de buscador findAllForType.

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

El ejemplo de script siguiente devuelve los nombres de todos los objetos de sistema host cuyo ID empieza por el dígito 1.

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

El script siguiente devuelve los nombres y los ID de todos los objetos de centro de datos que contienen la cadena DC en el nombre, ya sea en mayúsculas o en minúsculas. El script también recupera la propiedad etiqueta.

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