What’s New in VMware vSphere 5.5: Management APIs

After downloading the vSphere 5.5 SDK GA release last week, I started to look into the API reference immediately. Because I am pretty familiar with previous versions of vSphere APIs already, I just jumped directly into the “New and Changed Managed Object Elements in 5.5” page (there is a link on the home page of API Reference) as I had to work on the open source vijava API 5.5 which was released as beta last Friday.

There are new managed object types, new methods to existing managed object types, and new parameters to existing methods of existing managed object types. Among of these three types of additions, the new managed object types are the most important ones as they are most likely associated with new features in the vSphere product (not 1 and 1 mapping though). If you want to take time to read what’s new in vSphere 5.5 product, it definitely worths the time for a bigger context first. Here is the VMware official document What’s New in VMware vSphere® 5.5 Platform.

Bothered by SLOW Web UI to manage vSphere? Want to manage ALL your VMware vCenters, AWS, Azure, Openstack, container behind a SINGLE pane of glass? Want to search, analyze, report, visualize VMs, hosts, networks, datastores, events as easily as Google the Web? Find out more about vSearch 3.0: the search engine for all your private and public clouds.

There are totally 6 new managed object types added to vSphere 5.5. The following is a brief introduction of each of them and my comments on the design.

The DatastoreNamespaceManager is for “manipulating top-level directories of datastores which do not support the traditional top-level directory creation.” It has two methods: createDirectory() and deleteDirectory(). I don’t see anything related to namespace, so I don’t think it’s a good name. Moreover, it does not seem justified to have this new managed object type in my opinion – the two methods should have been easily added to the existing Datastore managed object.

The HostGraphicsManager “manages the graphics state of the host.” It has one property (graphicsInfo) and two methods (isSharedGraphicsActive(), and refreshGraphicsManager()). The methods are indeed very simple in terms of their responsibilities and signatures.

The HostVFlashManager object is used to “configure vFlash resource and vFlash cache on the ESX host.” With the added support of flash, it makes senese to have a managed object to manage this feature. The design is consistent with the other managed objects related to HostSystem.

The HostVsanInternalSystem “exposes low level access to CMMDS, as well as draft versions of VSAN object and disk management APIs that are subject to change in future releases. No compatibility is guaranteed on any of the APIs, including their prototype, behavior or result encoding.” As another important technology in storage, VSAN is getting momentum. The managed object has four methods (QueryCmmds(), QueryObjectsOnPhysicalVsanDisk(), QueryPhysicalVsanDisks(), QueryVsanObjects()). As their names suggest, these methods are for querying information from VSAN, not configuring VSAN. In other words, they are read-only.

The HostVsanSystem “exposes VSAN configuration primitives and serves as a host-level access point for relevant VSAN data objects.” It has one property and 7 methods (
addDisks_Task, initializeDisks_Task, queryDisksForVsan, queryHostStatus, removeDisk_Task, removeDiskMapping_Task, updateVsan_Task). To me, the design of this managed object and the HostVsanInternalSystem is not quite clear and does not really make senese.

The OpaqueNetwork “defines an opaque network, in the sense that the detail and configuration of the network is unknown to vShpere and is managed by a management plane outside of vSphere. However, the identifier and name of these networks is made available to vSphere so that host and virtual machine virtual ethernet device can connect to them.” The very interesting part is that OpaqueNetwork does not define any new property or method beyond what are inherited from its super type Network. It’s still possible that it has something more via VMware’s private APIs. Exposing a new managed object without new responsibility does not make much sense programatically, but does conceptually. It’s like promoting someone to be a manager but continue to do the same things as before, nothing more. This is not the first time though. VmwareDistributedVirtualSwitch managed object type used to be like this, but has a new method as this 5.5 release. That means VMware DVS now has something more than Cisco Nexus 1000V in terms of management APIs from VMware’s view.

This entry was posted in vSphere API and tagged , . Bookmark the permalink. Post a comment or leave a trackback: Trackback URL.

3 Trackbacks

  • […] The most important changes in this release is the support for vSphere 5.5 which was released on this Monday. We’ve added 6 more managed object types and new methods in existing managed object types. Even more are the new data object types, which are about 150 total. I’ll write a separate article on this subject later on. (Update: just published here) […]

  • By Welcome to vSphere-land! » vSphere 5.5 Link-O-Rama on October 2, 2013 at 8:57 pm

    […] What’s New in VMware vSphere 5.5: Management APIs (Double Cloud) VM Storage Policy APIs aka Storage Profile APIs will be available in vSphere 5.5 (Virtually Ghetto) Exploring the vSphere Flash Read Cache (vFRC) APIs Part 1 (Virtually Ghetto) How to add the missing ESXi 5.0 drivers to the ESXi 5.5 installation ISO (VMware Front Experience) PowerCLI 5.5 What’s New-Overview (VMware PowerCLI Blog) […]

  • By VMware Link Collection | Life on October 30, 2014 at 11:12 pm

    […] What’s New in VMware vSphere 5.5: Management APIs (Double Cloud) VM Storage Policy APIs aka Storage Profile APIs will be available in vSphere 5.5 (Virtually Ghetto) Exploring the vSphere Flash Read Cache (vFRC) APIs Part 1 (Virtually Ghetto) Exploring the vSphere Flash Read Cache (vFRC) APIs Part 2 (Virtually Ghetto) Exploring the vSphere Flash Read Cache (vFRC) APIs Part 3 (Virtually Ghetto) Automate the migration from Virtual Standard Switch to vSphere Distributed Switch using PowerCLI 5.5 (Virtually Ghetto) How to automate vFRC configurations using the command-line in ESXi (Virtually Ghetto) How to add the missing ESXi 5.0 drivers to the ESXi 5.5 installation ISO (VMware Front Experience) PowerCLI 5.5 What’s New-Overview (VMware PowerCLI Blog) […]

Post a Comment

Your email is never published nor shared. Required fields are marked *

*
*

You may use these HTML tags and attributes <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>

  • NEED HELP?


    My company has created products like vSearch ("Super vCenter"), vijavaNG APIs, EAM APIs, ICE tool. We also help clients with virtualization and cloud computing on customized development, training. Should you, or someone you know, need these products and services, please feel free to contact me: steve __AT__ doublecloud.org.

    Me: Steve Jin, VMware vExpert who authored the VMware VI and vSphere SDK by Prentice Hall, and created the de factor open source vSphere Java API while working at VMware engineering. Companies like Cisco, EMC, NetApp, HP, Dell, VMware, are among the users of the API and other tools I developed for their products, internal IT orchestration, and test automation.