VirtualDiskDrives
Applies To: System Center 2016 - Service Provider Foundation, System Center Technical Preview
VirtualDiskDrives
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 all virtual hard disks that are associated with all virtual machines and virtual machine templates for a specific stamp.
If you supply the ID property, the virtual disk drive with that identifier is returned.
Entity Properties
| Name | Type | Mandatory | Description |
|---|---|---|---|
| StampId | Edm.Guid | Yes | The identifier of the stamp to restrict the query to |
| ID | Edm.Guid | No | The identifier of the virtual disk drive |
POST
Creates a new virtual disk drive.
Entity Properties
| Name | Type | Mandatory | Description |
|---|---|---|---|
| StampId | Edm.Guid | Yes | The identifier of the stamp to restrict the query to |
| Bus | Edm.Int32 | Yes | Specifies the IDE bus to attach this virtual disk drive to. |
| 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. |
| VirtualHardDiskId | Edm.Guid | Yes | The identifier of the virtual disk that this virtual disk drive implements |
| SCSI | Edm.Boolean | No | Uses SCSI as the bus type. |
| FileName | Edm.String | Yes | The file name to rename the associated virtual hard disk when it is attached to this virtual disk drive |
| VMId | Edm.Guid | Yes | The identifier of the virtual machine to add this virtual disk drive to |
| Path | Edm.String | No | The path on the host to store the associated virtual hard disk Examples: 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 |
DELETE
Deletes a virtual disk drive.
Entity Properties
| Name | Type | Mandatory | Description |
|---|---|---|---|
| StampId | Edm.Guid | Yes | The identifier of the stamp to restrict the query to |
| ID | Edm.Guid | Yes | The identifier of the virtual disk drive to delete |