6.0

vSphere SDK for Perl Programming Guide
60 VMware, Inc.
Example
$client->EnumerateAssociatedInstances(
class_name => 'CIM_Foo',
selectors => \%hash;
associationclassname => 'CIM_Bar', #optional
role => 'CIM_Baz', #optional
resultclassname => 'CIM_Bat', #optional
resultrole => 'CIM_Quux', #optional
includeresult => \%hash, #optional
namespace => 'root/cimv2' #optional
EnumerateAssociatedInstanceNames
Returnsobjectswithonlythekeyvaluesoftheassociatedinstancepopulated.Theusageisthesameasfor
EnumerateAssociatedInstances.
EnumerateAssociationInstances
Returnsobjectscontainingassociationinstancesofwhichtheclassisapart.Theusageisthesameasfor
EnumerateAssociatedInstances.
EnumerateAssociationInstanceNames
Returnsobjectscontainingkeyvaluesoftheassociationinstancesofwhichtheclassisapart.Theusageisthe
sameasforEnumerateAssociatedInstances.
GetInstance
Retrievesaparticularinstanceofaclass.
Arguments
Acceptsthefollowingnamedarguments:
Returns
Printsafaultstringorreturnstheresultinahash.
role(optional) Rolethattheobjectplaysintheassociationclass.Themethodfilterstheresults
accordingtotherole.
resultclassname(optional) Resultclassname,whichmustbepresentintheassociation.Themethod
returnsonlythoseinstances.
resultrole(optional) Rolethattheresultclassplaysinthisinstance.The
methodreturnstheresults
basedonresultrole.
includeresult(optional) Furtherfiltersqueryresultsbasedonpropertiesoftheinstances.Youcanpass
inpropertiesasaname‐valuehash,thenpassinareferencetothishashinthe
includeresultnamedargument.
namespace DefaultCIMnamespace.Defaultisroot/cimv2.
Ifthenamespace
isnotroot/cimv2,youmustpassinthenamespaceofthe
classinthisargument.
Argument Description
Argument Description
class_name Nameoftheclasswhoseinstanceyouwanttoretrieve,passedasastring
options KeysfortheinstanceonwhichyouwanttoperformtheGetInstanceoperation.Theargumentis
passedasareferencetoahashcontainingthekeysinname‐valuepairs.
namespace DefaultCIMnamespace.Defaultis
root/cimv2.
Ifthenamespaceisnotroot/cimv2,youmustpassinthenamespaceoftheclassinthisargument.