Virtual Disk Manager Move Virtual Disk Task
Move a virtual disk and all related files from the source location specified by sourceName
and sourceDatacenter
to the destination location specified by destName
and destDatacenter
.
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.
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"
},
"force": false,
"profile": [
{
"_typeName": "string"
}
]
}
The name of the source, either a datastore path or a URL referring to the virtual disk to be moved.
Reference to an instance of the Datacenter managed object.
The name of the destination, either a datastore path or a URL referring to the destination virtual disk.
If true, overwrite any indentically named disk at the destination. If not specified, it is assumed to be false
User can specify new set of profile when moving virtual disk.
OK
{
"_typeName": "string",
"type": "string",
"value": "string"
}
FileFault: if an error occurs renaming the virtual disk.
InvalidDatastore: if the operation cannot be performed on the source or destination datastore.
{
"_typeName": "string",
"faultCause": "MethodFault Object",
"faultMessage": [
{
"_typeName": "string",
"key": "string",
"arg": [
{
"_typeName": "string",
"key": "string",
"value": {
"_typeName": "string"
}
}
],
"message": "string"
}
]
}