Share via


VirtualDiskDrive

 

Applies To: System Center 2016 - Service Provider Foundation, System Center Technical Preview

VirtualDiskDrive

Reads, creates, and deletes virtual disk drives that are associated with virtual machines or virtual machine templates.

HTTP Verbs

GET POST PUT DELETE
Yes Yes No Yes

GET

Gets the specified virtual hard disks.

If you supply the ID property, the virtual disk drive with that identifier is returned.

Entity Properties

Name Type Mandatory Description
ID Edm.Guid No The identifier of the virtual disk drive that contains the virtual machine
StampId Edm.Guid Yes The identifier of the stamp to restrict the query to
TemplateId Edm.Guid No The identifier of the virtual machine template that is associated with the virtual machine
VMId Edm.Guid No The identifier of the virtual machine

POST

Creates a new virtual disk drive.

Entity Properties

Name Type Mandatory Description
Bus Edm.Guid Yes Specifies the IDE bus to attach this virtual disk drive to.
FileName Edm.String Yes The file name to rename the associated virtual hard disk when it is attached to this virtual disk drive
IDE Edm.Boolean No Uses IDE as the bus type.
LUN Edm.Int32 Yes Specifies the logical unit number (LUN) for a virtual disk drive on an IDE or SCSI bus.
Path Edm.String No The path on the host to store the associated virtual hard diskExamples:

F:\
Local path

\\Library\Templates
UNC path

\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\
Volume GUID path

[storage1]\MyVMwareFolderForVMs\MyVM.vmx
VMware ESX path

Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]
Citrix XenServer path
SCSI Edm.Boolean No Uses SCSI as the bus type.
StampId Edm.Guid Yes The identifier of the stamp to restrict the query to
VirtualHardDiskId Edm.Guid Yes The identifier of the virtual disk that this virtual disk drive implements
VMId Edm.Guid Yes The identifier of the virtual machine to add this virtual disk drive to

DELETE

Deletes a virtual disk drive.

Entity Properties

Name Type Mandatory Description
ID Edm.Guid Yes The identifier of the virtual disk drive to delete
StampId Edm.Guid Yes The identifier of the stamp to restrict the query to

See Also

VMM Collections Reference R2