Class

VMware_VCloud_SDK_Vm

class VMware_VCloud_SDK_Vm extends VMware_VCloud_SDK_VApp_Abstract

Methods

string getEntityId()

Get vCloud ID of the vCloud resource entity from its data object.

from VMware_VCloud_SDK_Abstract
VMware_VCloud_API_TaskType deploy(VMware_VCloud_API_DeployVAppParamsType $params)

Deploy the vApp or VM.

from VMware_VCloud_SDK_VApp_Abstract
VMware_VCloud_API_TaskType undeploy(VMware_VCloud_API_UndeployVAppParamsType $params)

Undeploy the vApp or VM.

from VMware_VCloud_SDK_VApp_Abstract
VMware_VCloud_API_TaskType delete()

Delete the vApp or VM.

from VMware_VCloud_SDK_VApp_Abstract
VMware_VCloud_API_TaskType powerOn()

Power on the VM or all Vms contained in the vApp.

from VMware_VCloud_SDK_VApp_Abstract
VMware_VCloud_API_TaskType powerOff()

Power off the VM or all VMs contained in the vApp.

from VMware_VCloud_SDK_VApp_Abstract
VMware_VCloud_API_TaskType reset()

Reset the VM or all VMs contained in the vApp.

from VMware_VCloud_SDK_VApp_Abstract
VMware_VCloud_API_TaskType reboot()

Reboot the VM or all VMs contained in the vApp.

from VMware_VCloud_SDK_VApp_Abstract
VMware_VCloud_API_TaskType suspend()

Suspend the VM or all VMs contained in the vApp.

from VMware_VCloud_SDK_VApp_Abstract
VMware_VCloud_API_TaskType discardSuspendedState()

Discard suspended state of the VM or all VMs contained in the vApp.

from VMware_VCloud_SDK_VApp_Abstract
VMware_VCloud_API_TaskType shutdown()

Shutdown the VM or all VMs contained in the vApp.

from VMware_VCloud_SDK_VApp_Abstract
VMware_VCloud_API_MetadataType|VMware_VCloud_API_MetadataValueType|null getMetadata(string $key = null, string $domain = null)

Get metadata associated with the vApp/VM or metadata associated with the vApp/VM for the specified key in the specified domain.

from VMware_VCloud_SDK_VApp_Abstract
VMware_VCloud_API_TaskType mergeMetadata(VMware_VCloud_API_MetadataType $meta)

Merges the metadata for the vApp or VM with the information provided.

from VMware_VCloud_SDK_VApp_Abstract
VMware_VCloud_API_TaskType setMetadataByKey(string $key, VMware_VCloud_API_MetadataValueType $value, string $domain = null)

Sets the metadata for the particular key in the specified domain for the vApp or VM to the value provided.

from VMware_VCloud_SDK_VApp_Abstract
VMware_VCloud_API_TaskType deleteMetadataByKey(string $key, string $domain = null)

Deletes the metadata for the particular key in the specified domain for the vApp or VM.

from VMware_VCloud_SDK_VApp_Abstract
VMware_VCloud_API_ReferenceType getVmRef()

Get a reference to a VMware vCloud VM entity.

VMware_VCloud_API_VmType getVm()

Get a VMware vCloud VM entity.

string getId()

Constructs the vCloud entity ID of this VM from its UUID.

VMware_VCloud_API_LinkType|null getContainerVAppRef()

Get the link to the container of the VM.

VMware_VCloud_API_VAppType|null getContainerVApp()

Get the container of the VM.

VMware_VCloud_API_OVF_VirtualHardwareSection_Type getVirtualHardwareSettings()

Get virtual hardware settings of this VM.

VMware_VCloud_API_TaskType modifyVirtualHardwareSettings(VMware_VCloud_API_OVF_VirtualHardwareSection_Type $vhSection)

Modify the guest virtual hardware settings.

VMware_VCloud_API_OVF_RASD_Type getVirtualCpu()

Get the CPU settings of this VM.

VMware_VCloud_API_TaskType modifyVirtualCpu(VMware_VCloud_API_OVF_RASD_Type $cpu)

Modify the CPU settings of this VM.

VMware_VCloud_API_OVF_RASD_Type getVirtualMemory()

Get the memory settings of this VM.

VMware_VCloud_API_TaskType modifyVirtualMemory(VMware_VCloud_API_OVF_RASD_Type $mem)

Modify the memory settings of this VM.

VMware_VCloud_API_RasdItemsListType getVirtualDisks()

Get a RASD list object representing virtual disks of this VM.

VMware_VCloud_API_TaskType modifyVirtualDisks(VMware_VCloud_API_RasdItemsListType $rasdItems)

Modify virtual disk(s) of this VM.

VMware_VCloud_API_RasdItemsListType getVirtualNetworkCards()

Get a RASD list object representing virtual network cards of this VM.

VMware_VCloud_API_TaskType modifyVirtualNetworkCards(VMware_VCloud_API_RasdItemsListType $rasdItems)

Modify virtual network card(s) of this VM.

VMware_VCloud_API_RasdItemsListType getVirtualMedia()

Get a RASD list object representing virtual floppy and CD/DVD drives of this VM.

VMware_VCloud_API_OVF_OperatingSystemSection_Type getOperatingSystemSettings()

Get the operating system settings of this VM.

VMware_VCloud_API_TaskType modifyOperatingSystemSettings(VMware_VCloud_API_OVF_OperatingSystemSection_Type $os)

Modify the operating system settings of this VM.

VMware_VCloud_API_TaskType reconfigureVm(VMware_VCloud_API_VmType $params)

Updates Vm name, Description, and any or all of the following sections.

VMware_VCloud_API_NetworkConnectionSectionType getNetworkConnectionSettings()

Get the network connection settings of this VM.

VMware_VCloud_API_TaskType modifyNetworkConnectionSettings(VMware_VCloud_API_NetworkConnectionSectionType $net)

Modify the network connection settings of this VM.

VMware_VCloud_API_GuestCustomizationSectionType getGuestCustomizationSettings()

Get guest customization settings.

VMware_VCloud_API_TaskType modifyGuestCustomizationSettings(VMware_VCloud_API_GuestCustomizationSectionType $cs)

Modify the customization settings of this VM.

VMware_VCloud_API_TaskType insertMedia(VMware_VCloud_API_MediaInsertOrEjectParamsType $params)

Insert a virtual media.

VMware_VCloud_API_TaskType ejectMedia(VMware_VCloud_API_MediaInsertOrEjectParamsType $params)

Eject a virtual media.

null getScreenThumbnailImage(string $thumbnail)

Get a VM screen thumbnail image.

VMware_VCloud_API_ScreenTicketType getScreenTicket()

Get a VM screen ticket.

array getScreenTicketTokens()

Get a VM screen ticket tokens, in IP address, VM MOF, and encided-ticket

VMware_VCloud_API_MksTicketType acquireMksTicket()

Retrieve a mks ticket that you can use to gain access to the console of a running VM.

VMware_VCloud_API_VmPendingQuestionType getPendingQuestion()

Get a VM pending question.

null answerPendingQuestion(VMware_VCloud_API_VmQuestionAnswerType $answer)

Answer a VM pending question.

int getStatus()

Get the status of this VM.

VMware_VCloud_API_TaskType modify(string $name = null, string $description = null)

Modify name and/or description of this VM.

VMware_VCloud_API_TaskType installVMwareTools()

Installs VMware tools to the VM.

VMware_VCloud_API_RuntimeInfoSectionType getRuntimeInfo()

Get the runtime info section of the VM.

array|null getProductInfo()

Get the installed software information of the VM.

VMware_VCloud_API_TaskType modifyProductInfo(VMware_VCloud_API_OVF_ProductSection_Type $productInfo)

Modify the installed software information of the VM.

VMware_VCloud_API_TaskType consolidate()

Consolidates the VM.

VMware_VCloud_API_TaskType relocate(VMware_VCloud_API_RelocateParamsType $params)

Relocates the VM.

VMware_VCloud_API_TaskType upgradeHardwareVersion()

Upgrade virtual hardware version of the VM.

VMware_VCloud_API_TaskType attachDisk(VMware_VCloud_API_DiskAttachOrDetachParamsType $params)

Attach a disk to a VM.

VMware_VCloud_API_TaskType detachDisk(VMware_VCloud_API_DiskAttachOrDetachParamsType $params)

Detach a disk to a VM.

VMware_VCloud_API_TaskType enableNestedHypervisor()

Enable nested hypervisor of the VM.

VMware_VCloud_API_TaskType disableNestedHypervisor()

Disable nested hypervisor of the VM.

VMware_VCloud_API_TaskType CheckCompliance()

Perform storage profile compliance check on a VM.

VMware_VCloud_API_SnapshotSectionType getSnapshotSection()

Retrieve SnapshotSection element for a vApp or VM.

VMware_VCloud_API_ComplianceResultType getComplianceResult()

Get storage profile compliance result of the VM.

VMware_VCloud_API_VmCapabilitiesType getVmCapabilities()

Get capability of the VM.

VMware_VCloud_API_TaskType updateVmCapabilities(VMware_VCloud_API_VmCapabilitiesType $capType)

Update capability of the VM.

VMware_VCloud_API_TaskType createSnapshot(VMware_VCloud_API_CreateSnapshotParamsType $params)

Creates new snapshot of a virtual machine or of all the virtual machines in a vApp.

VMware_VCloud_API_TaskType removeAllSnapshots()

Removes all user created snapshots for a vApp or virtual machine.

VMware_VCloud_API_TaskType revertToCurrentSnapshot()

Reverts a vApp or virtual machine to the current snapshot, if any.

array getShadowVmsRefs(string $name = null)

Get collection of shadow vm references.

Details

public string getEntityId()

Get vCloud ID of the vCloud resource entity from its data object.

Return Value

string

public VMware_VCloud_API_TaskType deploy(VMware_VCloud_API_DeployVAppParamsType $params)

Deploy the vApp or VM.

public VMware_VCloud_API_TaskType undeploy(VMware_VCloud_API_UndeployVAppParamsType $params)

Undeploy the vApp or VM.

public VMware_VCloud_API_TaskType delete()

Delete the vApp or VM.

The vApp or VM has to be powered off and undeployed before it can be deleted.

public VMware_VCloud_API_TaskType powerOn()

Power on the VM or all Vms contained in the vApp.

public VMware_VCloud_API_TaskType powerOff()

Power off the VM or all VMs contained in the vApp.

public VMware_VCloud_API_TaskType reset()

Reset the VM or all VMs contained in the vApp.

public VMware_VCloud_API_TaskType reboot()

Reboot the VM or all VMs contained in the vApp.

public VMware_VCloud_API_TaskType suspend()

Suspend the VM or all VMs contained in the vApp.

public VMware_VCloud_API_TaskType discardSuspendedState()

Discard suspended state of the VM or all VMs contained in the vApp.

public VMware_VCloud_API_TaskType shutdown()

Shutdown the VM or all VMs contained in the vApp.

public VMware_VCloud_API_MetadataType|VMware_VCloud_API_MetadataValueType|null getMetadata(string $key = null, string $domain = null)

Get metadata associated with the vApp/VM or metadata associated with the vApp/VM for the specified key in the specified domain.

Parameters

string $key
string $domain

Return Value

VMware_VCloud_API_MetadataType|VMware_VCloud_API_MetadataValueType|null

public VMware_VCloud_API_TaskType mergeMetadata(VMware_VCloud_API_MetadataType $meta)

Merges the metadata for the vApp or VM with the information provided.

public VMware_VCloud_API_TaskType setMetadataByKey(string $key, VMware_VCloud_API_MetadataValueType $value, string $domain = null)

Sets the metadata for the particular key in the specified domain for the vApp or VM to the value provided.

Note: This will replace any existing metadata information.

Parameters

string $key
VMware_VCloud_API_MetadataValueType $value
string $domain

Return Value

VMware_VCloud_API_TaskType

public VMware_VCloud_API_TaskType deleteMetadataByKey(string $key, string $domain = null)

Deletes the metadata for the particular key in the specified domain for the vApp or VM.

Parameters

string $key
string $domain

Return Value

VMware_VCloud_API_TaskType

at line 10
public VMware_VCloud_API_ReferenceType getVmRef()

Get a reference to a VMware vCloud VM entity.

at line 21
public VMware_VCloud_API_VmType getVm()

Get a VMware vCloud VM entity.

at line 32
public string getId()

Constructs the vCloud entity ID of this VM from its UUID.

Return Value

string

at line 43
public VMware_VCloud_API_LinkType|null getContainerVAppRef()

Get the link to the container of the VM.

Return Value

VMware_VCloud_API_LinkType|null

at line 54
public VMware_VCloud_API_VAppType|null getContainerVApp()

Get the container of the VM.

Return Value

VMware_VCloud_API_VAppType|null

at line 66
public VMware_VCloud_API_OVF_VirtualHardwareSection_Type getVirtualHardwareSettings()

Get virtual hardware settings of this VM.

at line 79
public VMware_VCloud_API_TaskType modifyVirtualHardwareSettings(VMware_VCloud_API_OVF_VirtualHardwareSection_Type $vhSection)

Modify the guest virtual hardware settings.

at line 92
public VMware_VCloud_API_OVF_RASD_Type getVirtualCpu()

Get the CPU settings of this VM.

at line 105
public VMware_VCloud_API_TaskType modifyVirtualCpu(VMware_VCloud_API_OVF_RASD_Type $cpu)

Modify the CPU settings of this VM.

at line 118
public VMware_VCloud_API_OVF_RASD_Type getVirtualMemory()

Get the memory settings of this VM.

at line 131
public VMware_VCloud_API_TaskType modifyVirtualMemory(VMware_VCloud_API_OVF_RASD_Type $mem)

Modify the memory settings of this VM.

at line 157
public VMware_VCloud_API_RasdItemsListType getVirtualDisks()

Get a RASD list object representing virtual disks of this VM.

at line 169
public VMware_VCloud_API_TaskType modifyVirtualDisks(VMware_VCloud_API_RasdItemsListType $rasdItems)

Modify virtual disk(s) of this VM.

at line 182
public VMware_VCloud_API_RasdItemsListType getVirtualNetworkCards()

Get a RASD list object representing virtual network cards of this VM.

at line 194
public VMware_VCloud_API_TaskType modifyVirtualNetworkCards(VMware_VCloud_API_RasdItemsListType $rasdItems)

Modify virtual network card(s) of this VM.

at line 208
public VMware_VCloud_API_RasdItemsListType getVirtualMedia()

Get a RASD list object representing virtual floppy and CD/DVD drives of this VM.

at line 219
public VMware_VCloud_API_OVF_OperatingSystemSection_Type getOperatingSystemSettings()

Get the operating system settings of this VM.

at line 232
public VMware_VCloud_API_TaskType modifyOperatingSystemSettings(VMware_VCloud_API_OVF_OperatingSystemSection_Type $os)

Modify the operating system settings of this VM.

at line 251
public VMware_VCloud_API_TaskType reconfigureVm(VMware_VCloud_API_VmType $params)

Updates Vm name, Description, and any or all of the following sections.

VirtualHardwareSection OperatingSystemSection NetworkConnectionSection GuestCustomizationSection

Parameters

VMware_VCloud_API_VmType $params

Return Value

VMware_VCloud_API_TaskType

at line 264
public VMware_VCloud_API_NetworkConnectionSectionType getNetworkConnectionSettings()

Get the network connection settings of this VM.

at line 277
public VMware_VCloud_API_TaskType modifyNetworkConnectionSettings(VMware_VCloud_API_NetworkConnectionSectionType $net)

Modify the network connection settings of this VM.

at line 291
public VMware_VCloud_API_GuestCustomizationSectionType getGuestCustomizationSettings()

Get guest customization settings.

at line 304
public VMware_VCloud_API_TaskType modifyGuestCustomizationSettings(VMware_VCloud_API_GuestCustomizationSectionType $cs)

Modify the customization settings of this VM.

at line 319
public VMware_VCloud_API_TaskType insertMedia(VMware_VCloud_API_MediaInsertOrEjectParamsType $params)

Insert a virtual media.

at line 334
public VMware_VCloud_API_TaskType ejectMedia(VMware_VCloud_API_MediaInsertOrEjectParamsType $params)

Eject a virtual media.

at line 349
public null getScreenThumbnailImage(string $thumbnail)

Get a VM screen thumbnail image.

Parameters

string $thumbnail Path of the thumbnail image destination

Return Value

null

at line 361
public VMware_VCloud_API_ScreenTicketType getScreenTicket()

Get a VM screen ticket.

at line 378
public array getScreenTicketTokens()

Get a VM screen ticket tokens, in IP address, VM MOF, and encided-ticket

Return Value

array String array, keys are:
  • ip -- IP address to be connected by the remote console
  • mof -- managed object reference of the virtual machine
  • ticket -- decoded screen ticket

at line 401
public VMware_VCloud_API_MksTicketType acquireMksTicket()

Retrieve a mks ticket that you can use to gain access to the console of a running VM.

at line 413
public VMware_VCloud_API_VmPendingQuestionType getPendingQuestion()

Get a VM pending question.

at line 425
public null answerPendingQuestion(VMware_VCloud_API_VmQuestionAnswerType $answer)

Answer a VM pending question.

Parameters

VMware_VCloud_API_VmQuestionAnswerType $answer

Return Value

null

at line 452
public int getStatus()

Get the status of this VM.

The following are the possible VM status:

  • -1 -- could not be created
  • 0 -- unresolved
  • 1 -- resolved
  • 3 -- suspended
  • 4 -- powered on
  • 5 -- waiting for user input
  • 6 -- in an unknown state
  • 7 -- in an unrecognized state
  • 8 -- powered off
  • 9 -- in an inconsistent state

Return Value

int VM status

at line 465
public VMware_VCloud_API_TaskType modify(string $name = null, string $description = null)

Modify name and/or description of this VM.

Parameters

string $name New name of the VM
string $description New description of the VM

Return Value

VMware_VCloud_API_TaskType

at line 484
public VMware_VCloud_API_TaskType installVMwareTools()

Installs VMware tools to the VM.

at line 496
public VMware_VCloud_API_RuntimeInfoSectionType getRuntimeInfo()

Get the runtime info section of the VM.

at line 509
public array|null getProductInfo()

Get the installed software information of the VM.

Return Value

array|null VMwareVCloudAPIOVFProductSection_Type object array or null

at line 527
public VMware_VCloud_API_TaskType modifyProductInfo(VMware_VCloud_API_OVF_ProductSection_Type $productInfo)

Modify the installed software information of the VM.

at line 540
public VMware_VCloud_API_TaskType consolidate()

Consolidates the VM.

at line 554
public VMware_VCloud_API_TaskType relocate(VMware_VCloud_API_RelocateParamsType $params)

Relocates the VM.

at line 567
public VMware_VCloud_API_TaskType upgradeHardwareVersion()

Upgrade virtual hardware version of the VM.

at line 580
public VMware_VCloud_API_TaskType attachDisk(VMware_VCloud_API_DiskAttachOrDetachParamsType $params)

Attach a disk to a VM.

at line 595
public VMware_VCloud_API_TaskType detachDisk(VMware_VCloud_API_DiskAttachOrDetachParamsType $params)

Detach a disk to a VM.

at line 609
public VMware_VCloud_API_TaskType enableNestedHypervisor()

Enable nested hypervisor of the VM.

at line 621
public VMware_VCloud_API_TaskType disableNestedHypervisor()

Disable nested hypervisor of the VM.

at line 633
public VMware_VCloud_API_TaskType CheckCompliance()

Perform storage profile compliance check on a VM.

at line 645
public VMware_VCloud_API_SnapshotSectionType getSnapshotSection()

Retrieve SnapshotSection element for a vApp or VM.

at line 657
public VMware_VCloud_API_ComplianceResultType getComplianceResult()

Get storage profile compliance result of the VM.

at line 669
public VMware_VCloud_API_VmCapabilitiesType getVmCapabilities()

Get capability of the VM.

at line 682
public VMware_VCloud_API_TaskType updateVmCapabilities(VMware_VCloud_API_VmCapabilitiesType $capType)

Update capability of the VM.

at line 698
public VMware_VCloud_API_TaskType createSnapshot(VMware_VCloud_API_CreateSnapshotParamsType $params)

Creates new snapshot of a virtual machine or of all the virtual machines in a vApp.

Prior to creation of the new

snapshots, any existing user created snapshots associated with the virtual machines are removed.

at line 712
public VMware_VCloud_API_TaskType removeAllSnapshots()

Removes all user created snapshots for a vApp or virtual machine.

at line 724
public VMware_VCloud_API_TaskType revertToCurrentSnapshot()

Reverts a vApp or virtual machine to the current snapshot, if any.

at line 737
public array getShadowVmsRefs(string $name = null)

Get collection of shadow vm references.

vAppTemplate VM contains the shadow vm references. Applicable for vAppTemplate VM not for vApp VM.

Parameters

string $name Name of the shadow vm to get. If null, returns all

Return Value

array VMwareVCloudAPI_ReferenceType object array.