Create a new VDI instance, and return its handle.
| Return value | ||
| type | description | |
| VDI | reference to the newly created object | |
| Parameters | ||
| name | type | description |
| session_id | session | valid session reference |
| name_label | string | a human-readable name |
| name_description | string | a notes field containg human-readable description |
| SR | SR | storage repository in which the VDI resides |
| virtual_size | int | size of disk as presented to the guest (in bytes). Note that, depending on storage backend type, requested size may not be respected exactly |
| type | enum vdi_type | type of the VDI |
| sharable | bool | true if this disk may be shared |
| read_only | bool | true if this disk may ONLY be mounted read-only |
| other_config | Map[string,string] | additional configuration |
| xenstore_data | Map[string,string] | data to be inserted into the xenstore tree (/local/domain/0/backend/vbd/<domid>/<device-id>/sm-data) after the VDI is attached. This is generally set by the SM backends on vdi_attach. |
| sm_config | Map[string,string] | SM dependent data |
| tags | Set[string] | user-specified tags for categorization purposes |
| Errors | ||
| name | arguments | description |
- Message has both a synchronous and asynchronous version
- This is an implicit message, derived from its class