# Data Object - VirtualDeviceConfigSpec(vim.vm.device.VirtualDeviceSpec)

Property of
  VirtualMachineConfigSpec, VirtualMachineRelocateSpec
Extended by
  VirtualDiskConfigSpec
Extends
  DynamicData
See also
  VirtualDevice, VirtualDeviceConfigSpecBackingSpec, VirtualDeviceConfigSpecFileOperation, VirtualDeviceConfigSpecOperation, VirtualMachineBaseIndependentFilterSpec, VirtualMachineProfileSpec
Since
  2.0

## Data Object Description

The VirtualDeviceSpec data object type encapsulates change specifications for an individual virtual device. The virtual device being added or modified must be fully specified.

Properties

Name | Type | Description
--- | --- | ---
backing* | VirtualDeviceConfigSpecBackingSpec | BackingInfo configuration options. Each BackingSpec corresponds to a BackingInfo object. The member backing refers to the device.backing. Since vSphere API 6.5
changeMode* | xsd:string | The change mode of the device. The values of the mode will be one of ChangeMode enumerations. On unset, default to 'fail'. Since 8.0.0.1
device | VirtualDevice | Device specification, with all necessary properties set.
fileOperation* | VirtualDeviceConfigSpecFileOperation | Type of operation being performed on the backing of the specified virtual device. If no file operation is specified in the VirtualDeviceSpec, then any backing filenames in the VirtualDevice must refer to files that already exist. The "replace" and "delete" values for this property are only applicable to virtual disk backing files.
filterSpec* | VirtualMachineBaseIndependentFilterSpec[] | List of independent filters VirtualMachineIndependentFilterSpec to configure on the virtual device. Since vSphere API 7.0.2.1
operation* | VirtualDeviceConfigSpecOperation | Type of operation being performed on the specified virtual device. If no operation is specified, the spec. is ignored.
profile* | VirtualMachineProfileSpec[] | Virtual Device Profile requirement. Profiles are solution specifics. Storage Profile Based Management(SPBM) is a vSphere server extension. The API users who want to provision VMs using Storage Profiles, need to interact with SPBM service. This is an optional parameter and if user doesn't specify profile, the default behavior will apply. Since vSphere API 5.5
Properties inherited from DynamicData
None

*Need not be set
Show WSDL type definition
<complexType xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="VirtualDeviceConfigSpec"> <complexContent> <extension base="sms:DynamicData"> <sequence> <element name="operation" type="sms:VirtualDeviceConfigSpecOperation" minOccurs="0"/> <element name="fileOperation" type="sms:VirtualDeviceConfigSpecFileOperation" minOccurs="0"/> <element name="device" type="sms:VirtualDevice"/> <element name="profile" type="sms:VirtualMachineProfileSpec" minOccurs="0" maxOccurs="unbounded"/> <element name="backing" type="sms:VirtualDeviceConfigSpecBackingSpec" minOccurs="0"/> <element name="filterSpec" type="sms:VirtualMachineBaseIndependentFilterSpec" minOccurs="0" maxOccurs="unbounded"/> <element name="changeMode" type="xsd:string" minOccurs="0"/> </sequence> </extension> </complexContent> </complexType>