6.5
Table Of Contents
- vSphere SDK for Perl Programming Guide
- Contents
- Getting Started with vSphere SDK for Perl
- Writing vSphere SDK for Perl Scripts
- Refining vSphere SDK for Perl Scripts
- Creating and Using Filters
- Filtering Views Selectively Using Properties
- Retrieving the ServiceInstance Object on a vSphere Host
- Saving and Using Sessions
- Using Multiple Sessions
- Learning About Object Structure Using Data::Dumper
- Specifying Untyped Arguments in Scheduled Tasks and Callbacks
- Using Advanced Subroutines
- vSphere SDK for Perl Subroutine Reference
- Web Services for Management Perl Library
- Credential Store Perl Library
VMware, Inc. 55
Chapter A Web Services for Management Perl Library
Example
$client->register_xml_ns((wsen => 'http://www.dmtf.org/wsen'));
DeclaresaprefixwsenwiththeURLhttp://www.dmtf.org/wsenintheglobalXMLnamespace.
register_class_ns
RegistersextraResourceURIsthattheWS‐Managementservermightrequire.Bydefault,theconstructor
providesasetofResourceURIsonlyforclassesintheCIMschema.Classeswithotherschemanames,suchas
VMware_*classes,requireadifferentResourceURIwhenenumeratedusingthevSphereSDKforPerl.
Youcanfindthe
ResourceURIscorrespondingtoothersupportedschemasintheOpenWSManconfiguration
file,whichislocatedintheserverʹsfilesystemat/etc/openwsman/openwsman.conf.TheResourceURIsare
listedinthevalueofthevendor_namespacesconfigurationparameter.
Arguments
Ahash.Keysaretheprefixes,valuesaretherelativeURLsasvalues.
Example
$client->register_class_ns((OMC => 'http://schema.omc-project.org/wbem/wscim/1/cim-schema/2',
VMware => 'http://schemas.vmware.com/wbem/wscim/1/cim-schema/2'));
RegisterstheResourceURIsneededtoenumerateclassesintheOMCandVMwareschemas.
Identify
Performsthewsmid:Identifyoperation,whichcausestheWS‐Managementservertoidentifyitself.Helps
youdeterminewhethertheserverisupandrunning.
Arguments
Noarguments.
Returns
ReturnsaSOAP::SOMobject,whichyoucanusetoparsetheresultsordoerrorcorrection.
Enumerate
Filtersresultsdependingontheargumentsyoupassin.Severalargumentsperformgenericoperationsthat
areimplementedinanotherclass,asdescribedin“GenericCIMOperationswithWSMan::GenericOps”on
page 57.Otherargumentsimplementenumerationfornon‐standard‐compliantservers.Thisdocument
discussesthemostcommonarguments.LookatthePerlcode
forinformationonotherarguments.
Arguments
Acceptsthefollowingarguments:
Argument Description
class_name Specifiestheclassthatyouwanttoenumerate.Thisargumentispassedasastring.
namespace DefaultCIMnamespace.Defaultisroot/cimv2.
Ifthenamespaceisnotroot/cimv2,youmustpassinthenamespaceoftheclassinthis
argument.
enummode (optional) SpecifiesanenumerationmodesuchasEnumerateEPRorEnumerateEPRandObject.
This
argumentispassedasastring.
polymorphism (optional) Specifiespolymorphismmodes,passedinasastring.Forexample
IncludeSubClassProperties,ExcludeSubClassProperties,andNone.