VMware Infrastructure (VI) SDK 2.5 Deprecations Summary
Several properties and types available through the VI API 2.0 have been deprecated in VI API 2.5. The table lists the deprecated enumeration types, fault types, managed- and data-object properties, and managed object methods, and identifies the new feature that takes its place.
For example, the QueryMemoryOverhead operation, available through HostSystem managed objects, is deprecated: QueryMemoryOverheadEx should be used for new development. A Java sample, demonstrating using the new operation, is included in the SDK download:
\samples\Axis\java\com\vmware\samples\version\querymemoryoverhead\QueryMemoryOverheadV25.java
| Name of object type or property | As of VI API 2.5, use instead... |
| Enumerated Types
| |
LicenseManagerLicenseKey | Use QueryLicenseSourceAvailability to obtain an array of LicenseAvailabilityInfo data objects (which in turn, comprises LicenseFeatureInfo data objects and status information about number of licenses and availability).
| |
DrsRecommendationReasonCode | Use the RecommendationReasonCode enumerated type. |
|
Fault Types
| |
CpuCompatibilityUnknown | Use CpuIncompatible and its subclasses.
| |
IDEDiskNotSupported | Use the DeviceControllerNotSupported fault type.
|
| Data Object Types
| |
ClusterConfigInfo | Use the ClusterConfigInfoEx data object type.
| |
ClusterConfigSpec | Use the ClusterConfigSpecEx data object type.
| |
ClusterDrsRecommendation | Use ClusterRecommendation.
|
| Managed Object Type Properties
| |
ClusterComputeResource.configuration | Use ComputeResource.configurationEx
| |
ClusterComputeResource.drsRecommendation | Use ClusterComputResource.recommendation
| |
LicenseManager.featureInfo | Use QuerySupportedFeatures.
|
| Managed Object Type Methods
| |
ReconfigureCluster_Task | Use ReconfigureComputeResource_Task.
| |
RecommendHostsForVm | Use PowerOnMultiVM_Task. RecommendHostsForVm cannot make any recommendations if DRS cannot find the specified host in the cluster. With PowerOnMultiVM_Task, DRS attempts to migrate virtual machines and power on hosts in standby mode, given the same conditions.
| |
DestroyDatastore | Do not use this method: DestroyDatastore throws ResourceInUse. Datastores are automatically removed when no longer in use, so this method is unnecessary.
| |
CreateCluster | Use CreateClusterEx.
| |
DeleteFile | Use DeleteDatastoreFile_Task (a method of the new FileManager managed object.
| |
QueryMemoryOverhead | Use QueryMemoryOverheadEx.
| |
DestroyNetwork | Do not use this method: DestroyNetwork throws ResourceInUse. Networks are automatically removed when no longer in use, so this method is unnecessary.
| |
CreatePerfInterval | Use UpdatePerfInterval. Historical intervals cannot be created.
| |
RemovePerfInterval | Use UpdatePerfInterval. Historical intervals cannot be removed.
|
|
Data Object Type Properties
| |
ClusterDasVmConfigInfo.restartPriority | Use restartPriority. If this value is specified using both places, the value in restartPriority has precedence.
| |
ClusterDasVmConfigInfo.powerOffOnIsolation | Use isolationResponse. If a value is specified in both powerOffOnIsolation and isolationResponse, the value in isolationResponse takes precedence and the value in powerOffOnIsolation is ignored.
| |
CustomizationWinOptions.deleteAccounts | Deleting user accounts as part of a customization routine is not supported as of VI API 2.5: the deleteAccounts property is ignored. To change the administrator password, set the administrator password to blank in the master vm. Sysprep will then be able to change the password to the one specified by the password.
| |
VirtualMachineFlagInfo.runWithDebugInfo | Use the new monitorType property (an enumeration comprising string values “debug,” “release,” and “stats”).
|
Copyright © 2007, VMware, Inc. All rights not expressly granted herein
are reserved.
Last updated 5-May-2008 3:45 pm
|