VirtualDiskFlatVer2BackingOption

VirtualDiskFlatVer2BackingOption

This data object type contains the available options when backing a virtual disk using a host file with the flat file format used in VMware Server and in ESX Server 2.x and greater.

Flat disks are pre-allocated, whereas sparse disks are grown as needed.

AllOf

This class requires all of the following:

VirtualDeviceFileBackingOption

JSON Example

{
    "_typeName": "string",
    "type": "string",
    "fileNameExtensions": {
        "_typeName": "string",
        "valueIsReadonly": false,
        "choiceInfo": [
            {
                "_typeName": "string",
                "label": "string",
                "summary": "string",
                "key": "string"
            }
        ],
        "defaultIndex": 0
    },
    "diskMode": {
        "_typeName": "string",
        "valueIsReadonly": false,
        "choiceInfo": [
            {
                "_typeName": "string",
                "label": "string",
                "summary": "string",
                "key": "string"
            }
        ],
        "defaultIndex": 0
    },
    "split": {
        "_typeName": "string",
        "valueIsReadonly": false,
        "supported": false,
        "defaultValue": false
    },
    "writeThrough": {
        "_typeName": "string",
        "valueIsReadonly": false,
        "supported": false,
        "defaultValue": false
    },
    "growable": false,
    "hotGrowable": false,
    "uuid": false,
    "thinProvisioned": {
        "_typeName": "string",
        "valueIsReadonly": false,
        "supported": false,
        "defaultValue": false
    },
    "eagerlyScrub": {
        "_typeName": "string",
        "valueIsReadonly": false,
        "supported": false,
        "defaultValue": false
    },
    "deltaDiskFormat": {
        "_typeName": "string",
        "valueIsReadonly": false,
        "choiceInfo": [
            {
                "_typeName": "string",
                "label": "string",
                "summary": "string",
                "key": "string"
            }
        ],
        "defaultIndex": 0
    },
    "deltaDiskFormatsSupported": [
        {
            "_typeName": "string",
            "datastoreType": "string",
            "deltaDiskFormat": {
                "_typeName": "string",
                "valueIsReadonly": false,
                "choiceInfo": [
                    {
                        "_typeName": "string",
                        "label": "string",
                        "summary": "string",
                        "key": "string"
                    }
                ],
                "defaultIndex": 0
            }
        }
    ],
    "virtualDiskFormat": {
        "_typeName": "string",
        "valueIsReadonly": false,
        "choiceInfo": [
            {
                "_typeName": "string",
                "label": "string",
                "summary": "string",
                "key": "string"
            }
        ],
        "defaultIndex": 0
    }
}

diskMode

Required

The disk mode.

Valid disk modes are:

• persistent
• independent_persistent
• independent_nonpersistent

See also VirtualDiskModeEnum.

split

Required

Flag to indicate whether or not the host supports allowing the client to select whether or not a disk should be split.

writeThrough

Required

Flag to indicate whether or not the host supports allowing the client to select "writethrough" as a mode for virtual disks.

Typically, this is available only for VMware Server Linux hosts.

boolean

growable

Required

Indicates whether or not this disk backing can be extended to larger sizes through a reconfigure operation.

If set to true, reconfiguring this virtual disk with a capacityInKB value greater than its current value will grow the disk to the newly specified size.

boolean

hotGrowable

Required

Indicates whether or not this disk backing can be extended to larger sizes through a reconfigure operation while the virtual machine is powered on.

If set to true, reconfiguring this virtual disk with a capacityInKB value greater than its current value will grow the disk to the newly specified size while the virtual machine is powered on.

boolean

uuid

Required

Flag to indicate whether this backing supports disk UUID property.

thinProvisioned

Required

Flag to indicate if this backing supports thin-provisioned disks.

When creating a thin-provisioned disk (or converting an existing disk to to a thin-provisioned one), both the target datastore and the host accessing it must support thin-provisioning. This flag indicates only the host capability. See perFileThinProvisioningSupported for datastore capability.

eagerlyScrub

Required

Flag to indicate if this backing supports eager scrubbing.

deltaDiskFormat

Required

Deprecated as of vSphere API 5.1, please use deltaDiskFormatsSupported.

Delta disk formats supported.

Valid values are:

• redoLogFormat
• nativeFormat

array of VirtualDiskDeltaDiskFormatsSupported

deltaDiskFormatsSupported

Required

Delta disk formats supported for each datastore type.

virtualDiskFormat

Optional

Virtual disk format.

See DatastoreSectorFormatEnum for the list of supported types.

Since: vSphere API Release 9.0.0.0

Property Of

ArrayOfVirtualDiskFlatVer2BackingOption