VMware

VMware vSphere Web Services SDK 4.0 Release Notes

Last updated:   7-May-2009

release notes   |   Known Issues   |   Deprecations   |   Behavior Changes

Deprecations Summary

Several properties and types defined for the API have been deprecated as of vSphere API 4.0. This table lists each deprecated API element and identifies the new feature that takes its place.

Name of deprecated type, method, or propertyAs of vSphere API 4.0, use instead...
Enumerated Types
VirtualMachineToolsStatus Use the VirtualMachineToolsVersionStatus and VirtualMachineToolsRunningStatus enumerated types.
ValidateMigrationTestType Use CheckTestType.
Enumerated Type Constants
degraded (ScsiLunState enumeration type) The degraded state is no longer reported. If one or more paths to the LUN are down, I/O is still possible. Additional path failures can result in lost connectivity.
lostCommunication (ScsiLunState enumeration type) The lostCommunication state is no longer reported. No more paths are available to the LUN.
Managed Object Types
HostVMotionSystem Use HostVirtualNicManager.
Managed Object Methods
CheckLicenseFeature Use QueryAssignedLicenses.
ConfigureLicenseSource Use UpdateLicense.
DisableFeature Use RemoveAssignedLicense.
EnableFeature Use UpdateAssignedLicense.
GetPublicKey Use trusted certificates and LoginExtensionBySubjectName, or SetExtensionCertificate and LoginExtensionByCertificate.
InstallHostPatch_Task Use InstallHostPatchV2_Task.
QueryLicenseSourceAvailability Use QueryAssignedLicenses.
QuerySupportedFeatures Use QueryAssignedLicenses.
QueryLicenseUsage Use QueryAssignedLicenses.
QueryVMotionCompatibility Use QueryVMotionCompatibilityEx_Task.
RenameDatastore Use Rename_Task.
ScanHostPatch_Task Use ScanHostPatchV2_Task.
SetLicenseEdition Use QueryAssignedLicenses.
SetPublicKey Use trusted certificates and LoginExtensionBySubjectName (SessionManager), or SetExtensionCertificate (ExtensionManager) and LoginExtensionByCertificate (SessionManager).
ValidateMigration Use the VirtualMachineProvisioningChecker managed object.
Managed Object Properties
vmotionSystem property of HostConfigManager. Use the virtualNicManager property of HostConfigManager to manage the VMotion configuration of the host.
offloadCapabilities property of HostNetworkSystem . The host uses the system defaults for offload capabilities.
diagnostics property of LicenseManager. This property is no longer used.
licensedEdition property of LicenseManager. Use the QueryAssignedLicenses method in LicenseAssignmentManager .
source property of LicenseManager. Use the QueryAssignedLicenses method in LicenseAssignmentManager to get evaluation information.
sourceAvailable property of LicenseManager. This property is no longer used.
layout property of VirtualMachine. Use the layoutEx property of VirtualMachine.
Data Object Types
HostNetOffloadCapabilities The host will use the system defaults for offload capabilities.
HostVMotionInfo Use HostVirtualNicManagerInfo.
VirtualMachineFileLayout Use VirtualMachineFileLayoutEx.
Data Object Properties
yellow2red, red2yellow, green2yellow, and yellow2green properties of AlarmTriggeringAction Use the AlarmTriggeringActionTransitionSpec data object.
currentFailoverLevel property of ClusterComputeResourceSummary Use the currentFailoverLevel property of ClusterFailoverLevelAdmissionControlInfo.
failoverLevel property of ClusterDasConfigInfo. Use the ClusterFailoverLevelAdmissionControlPolicy to set admissionControlPolicy.
eventType property of EventAlarmExpression. Use the eventTypeId property of EventAlarmExpression.
type property of EventFilterSpec. Use the eventTypeId property of EventFilterSpec.
toolsStatus property of GuestInfo. Use the toolsVersionStatus and toolsRunningStatus properties of GuestInfo.
offloadCapabilities property of HostConfigInfo. The system defaults will be used.
vmotion property of HostConfigInfo. Use the virtualNicManagerInfo property of HostConfigInfo.
vmotionSystem property of HostConfigManager. Use the virtualNicManager property of HostConfigManager.to manage the VMotion configuration of the host.
pathState property of HostMultipathInfoPath. System reported path states are available in the state property of HostMultipathInfoPath. Paths slated for I/O can be found using the isWorkingPath method of HostMultipathInfoPath.
offloadPolicy property of HostNetworkPolicy. The system defaults will be used.
inPassthroughMode property of VirtualEthernetCardNetworkBackingInfo. This property is no longer supported.
disableSnapshotsSupported property of VirtualMachineCapability. The value returned from the server is always false.
snapshotDisabled property of VirtualMachineFlagInfo. The server ignores this property.
toolsStatus property of VirtualMachineGuestSummary Use the toolsVersionStatus and toolsRunningStatus propeties of VirtualMachineGuestSummary.