Virtual Disk Manager Copy Virtual Disk Task
Copy a virtual disk, performing conversions as specified in the spec.
If source (or destination) name is specified as a URL, then the corresponding datacenter parameter may be omitted.
If source and destination resolve to the same file system location, the call has no effect, regardless of destSpec content.
Requires Datastore.FileManagement privilege on both source and destination datastores.
Required privileges: System.View
The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId
, in this case VirtualDiskManager/{moId}
.
The vSphere release schema. The current specification covers vSphere 8.0.2.0 APIs.
{
"sourceName": "string",
"sourceDatacenter": {
"_typeName": "string",
"type": "string",
"value": "string"
},
"destName": "string",
"destDatacenter": {
"_typeName": "string",
"type": "string",
"value": "string"
},
"destSpec": {
"_typeName": "string",
"diskType": "string",
"adapterType": "string"
},
"force": false
}
The name of the source, either a datastore path or a URL referring to the virtual disk to be copied.
Reference to an instance of the Datacenter managed object.
The name of the destination, either a datastore path or a URL referring to the virtual disk to be created.
The force flag is currently ignored. The FileAlreadyExists fault is thrown if the destination file already exists.
This method returns a Task object with which to monitor the operation.
{
"_typeName": "string",
"type": "string",
"value": "string"
}
FileFault: if an error occurs cloning the virtual disk.
InvalidDatastore: if the operation cannot be performed on the source or destination datastore.
InvalidDiskFormat: if the destination's format is not supported.
{
"_typeName": "string",
"faultCause": "MethodFault Object",
"faultMessage": [
{
"_typeName": "string",
"key": "string",
"arg": [
{
"_typeName": "string",
"key": "string",
"value": {
"_typeName": "string"
}
}
],
"message": "string"
}
]
}