vSphere SDK for Perl Programming Guide - Documentation - VMware

vSphere SDK for Perl Programming Guide
Argument Description
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.
Example
$client->EnumerateAssociatedInstances(
EnumerateAssociatedInstanceNames
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
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:
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.
Returns
Prints a fault string or returns the result in a hash.
60 VMware, Inc.