XML element VirtualMachine

Name: VirtualMachine

Entity represents encapsulation of virtual machine, the files of which are stored and managed by Datastore / Tintri System. ManagedEntity uuid will be set to the primary tintriUuid. The Tintri assigned unique identifier for this virtual machine. It can be hypervisor dependent to some extent, but also linked to Tintri File System implementation. For example, for VMware VM, it would look as:
<File System UUID> -VIM- <VMX file id hexadecimal representation>

Data Structure

{
   "typeId": "com.tintri.api.rest.v310.dto.domain.VirtualMachine",
   "diskFormatDescription": <String>,
   "hasSyncVmFileLevelRestoreDisk": <Boolean>,
   "isDeleted": <Boolean>,
   "isLive": <Boolean>,
   "lastConfigChangedTime": DateTime,
   "lastUpdatedTime": DateTime,
   "localAlias": <String>,
   "pinnedType": 'NOT_PINNED' | 'PARTIALLY_PINNED' | 'PINNED',
   "provisionedType": 'THICK' | 'THIN' | 'PENDING',
   "supportMode": <String>,
   "timeDeleted": <Date>,
   "tintriUuidAliasList": <String>,
   "vmstoreName": <String>,
   "vmstoreTintriUuid": <String>,
   "affinityRule": VirtualMachineAffinityRule,
   "composition": VirtualMachineComposition,
   "migration": VirtualMachineMigrationInfo,
   "policyErrors": [PolicyError],
   "qosConfig": VirtualMachineQoSConfig,
   "replication": VirtualMachineReplicationInfo,
   "serviceGroup": VirtualMachineServiceGroupInfo,
   "snapshot": VirtualMachineSnapshotInfo,
   "stat": Stats,
   "tagCollections": [TagCollection],
   "uuid": Uuid,
   "vmware": VirtualMachineVmwareInfo,
}

Elements
Name	Type	Description
affinityRule	VirtualMachineAffinityRule	The affinity rule.
composition	VirtualMachineComposition	TgcOnly Information about VM artifacts in the cluster managed by this Tintri Global Center.
migration	VirtualMachineMigrationInfo	Obtains the virtual machine replication information.
policyError (wrapped by policyErrors)	xsd:list[PolicyError]	TgcOnly Errors associated with per-VM policies which require user intervention to resolve.
qosConfig	VirtualMachineQoSConfig	Obtains the virtual machine QoS config information.
replication	VirtualMachineReplicationInfo	Obtains the virtual machine replication information.
serviceGroup	VirtualMachineServiceGroupInfo	Obtains the VM's service group information. A service group is a logical entity that groups one or more virtual machines together for the ease of classification.
snapshot	VirtualMachineSnapshotInfo	Obtains the virtual machine snapshot information.
stat	Stats	Statistics as for the virtual machine.
tagCollections	xsd:list[TagCollection]	Obtains the list of tag collections that are associated with this virtual machine. A tag collection is a collection of tags collected from a hypervisor instance, and from multiple sources. Tags provide a way to annotate objects. Tags can be used for different purposes such as grouping, sorting or searching on objects. All the tags in this collection are collected from one hypervisor instance, and from multiple sources. Some examples of sources are VMware vSphere metadata, VMware vSphere Custom Attributes, VMware vSphere Tags, OpenStack instance tags.
uuid	Uuid	Unique Tintri UUID for the object
vmware	VirtualMachineVmwareInfo	Obtains hypervisor information about the VM.

Attributes

Name

Type

Description

diskFormatDescription

xsd:string

Obtains the disk format description.

hasSyncVmFileLevelRestoreDisk

xsd:boolean

'True' if virtual machine contains virtual disk that is restored via SyncVM File-Level Restore.

isDeleted

xsd:boolean

Return the flag indicating whether this virtual machine is deleted

isLive

xsd:boolean

Checks if is live.

lastConfigChangedTime

DateTime

Latest timestamp when snapshot schedule or replication configuration for this VM was changed.

lastUpdatedTime

DateTime

Last time the entity is updated in the format YYYY-MM-DDThh:mm:ss.ms-/+zz:zz

localAlias

xsd:string

Alias used for the entity instance in this Tintri API server. If an alias is not set, then localAlias is not returned.

pinnedType

NOT_PINNED | PARTIALLY_PINNED | PINNED

Obtains the pin type of the VM.

NOT_PINNED	VM disks are not pinned in cache
PARTIALLY_PINNED	Some, but not all of the VM disks are pinned in cache
PINNED	All VM disks are pinned in cache

provisionedType

THICK | THIN | PENDING

Obtains the provisioned type of the VM.

THICK	At least one VM disk is thick provisioned
THIN	All VM disks are thin provisioned
PENDING	Provision type not available until the next statistics reporting

supportMode

xsd:string

Obtains the support mode for the this VM.

timeDeleted

xsd:datetime

Obtains the timestamp the VM was deleted.

tintriUuidAliasList

xsd:list[xsd:string]

Obtains a list of Tintri UUID aliases. An alias is another Tintri UUID that was used to identify the same VM.

vmstoreName

xsd:string

TgcOnly Name of the primary VMstore for the VM

vmstoreTintriUuid

xsd:string

TgcOnly Tintri UUID of the primary VMstore for the VM