Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |