VirtualDiskRawDiskMappingVer1BackingInfo
This data object type contains information about backing a virtual disk using a raw device mapping.
Supported for ESX Server 2.5 and 3.x.
{
"_typeName": "string",
"fileName": "string",
"datastore": {
"_typeName": "string",
"type": "string",
"value": "string"
},
"backingObjectId": "string",
"lunUuid": "string",
"deviceName": "string",
"compatibilityMode": "string",
"diskMode": "string",
"uuid": "string",
"contentId": "string",
"changeId": "string",
"parent": {
"_typeName": "string",
"fileName": "string",
"datastore": {
"_typeName": "string",
"type": "string",
"value": "string"
},
"backingObjectId": "string",
"lunUuid": "string",
"deviceName": "string",
"compatibilityMode": "string",
"diskMode": "string",
"uuid": "string",
"contentId": "string",
"changeId": "string",
"parent": "VirtualDiskRawDiskMappingVer1BackingInfo Object",
"deltaDiskFormat": "string",
"deltaGrainSize": 0,
"sharing": "string"
},
"deltaDiskFormat": "string",
"deltaGrainSize": 0,
"sharing": "string"
}Unique identifier of the LUN accessed by the raw disk mapping.
The host-specific device the LUN is being accessed through.
If the target LUN is not available on the host then it is empty. For example, this could happen if it has accidentally been masked out.
The compatibility mode of the raw disk mapping (RDM).
This must be specified when a new virtual disk with an RDM backing is created. On subsequent virtual machine reconfigurations, this property should be handled as follows, depending on the version of the host:
On ESX Server 2.5, the compatibility mode of an RDM backing is a characteristic of the virtual machine's configuration. When reconfiguring a virtual machine that currently uses a virtual disk backed by an RDM, the compatibility mode of that backing may be modified. When reconfiguring a virtual machine to add an existing virtual disk backed by an RDM, the compatibility mode of that backing may be specified. If left unspecified it defaults to "physicalMode".
On ESX Server 3.x, the compatibility mode of an RDM backing is a characteristic of the RDM itself. Once the RDM is created, its compatibility mode cannot be changed by reconfiguring the virtual machine. When reconfiguring a virtual machine to add an existing virtual disk backed by an RDM, the compatibility mode of that backing must be left unspecified.
See also VirtualDiskCompatibilityModeEnum.
The disk mode.
Valid values are:
Disk modes are only supported when the raw disk mapping is using virtual compatibility mode.
See also VirtualDiskModeEnum.
Disk UUID for the virtual disk, if available.
Disk UUID is not available if the raw disk mapping is in physical compatibility mode.
Content ID of the virtual disk file, if available.
A content ID indicates the logical contents of the disk backing and its parents.
This property is only guaranteed to be up to date if this disk backing is not currently being written to by any virtual machine.
The only supported operation is comparing if two content IDs are equal or not. The guarantee provided by the content ID is that if two disk backings have the same content ID and are not currently being written to, then reads issued from the guest operating system to those disk backings will return the same data.
The change ID of the virtual disk for the corresponding snapshot or virtual machine.
This can be used to track incremental changes to a virtual disk. See QueryChangedDiskAreas.
This data object type contains information about backing a virtual disk using a raw device mapping.
Supported for ESX Server 2.5 and 3.x.
The format of the delta disk.
This field is valid only for a delta disk.
See DeltaDiskFormat for the supported formats. The default value used for VM with hardware version 8 and lower is redoLogFormat. The default value used for VM with hardware version 9 and higher is seSparseFormat.
nativeFormat is not supported for bask disk of type RawDiskMappingVer1BackingInfo.
Grain size in kB for a delta disk of format type seSparseFormat.
The default size is 4 kB. The grain size of Flex-SE delta disks when the base disk is of type RawDiskMappingVer1BackingInfo. The DeltaDiskFormat must also be set to seSparseFormat.
The sharing mode of the virtual disk.
See VirtualDiskSharingEnum. The default value is no sharing.