Get Local VM Disks
DescriptionRetrieve information about the disks of a VM.
Request
URLURL
Path Parameters
Path Parameters
The ID of the pairing between this vSphere Replication server and the remote one.
The ID of the vCenter server
The ID of a VM
Query Parameters
Query Parameters
The filter value by which to filter the result data. Must be used in combination with filter_prop parameter. Supports for nested fields. Example: https://dr-server/api/vms?filter_property=name&filter=vm-1&filter=vm-2
The name of the field by which to filter the result data. Must be used in combination with filter parameter. Supports for nested fields. Example: https://dr-server/api/vms?filter_property=name&filter=vm-1
Specify the limit size of the result data. In combination with offset parameter provides paging functionality. If none - configuration property ‘defaultResponsePageSize’ in REST API configuration file is taken into account. If configuration property is not defined - default value of 100 is taken into account.
limit example
"10"
The amount of elements to skip in the response. In combination with limit parameter provides paging functionality. Must be used in combination with limit parameter. If none - default value of 0 is taken into account. Example: https://dr-server/api/vms?limit=10&offset=10
offset example
"10"
Define desired sort order by field of the result data. Must be used in combination with sort_by. Supported values: asc, ascending, desc, descending.
Define desired sort by field of the result data. If order_by is not specified, ascending is used as default.
sort_by example
"name"
Authentication
Response
Response BodyResponse Body
200 OK
Virtual machine disks.
{
"_meta": {
"errors": [
{
"code": "string",
"field": "string",
"message": "string"
}
],
"limit": 0,
"links": {
"next": {
"href": "string"
},
"previous": {
"href": "string"
},
"self": {
"href": "string"
}
},
"offset": 0,
"total": 0
},
"list": [
{
"capacity": 0,
"controller_key": 0,
"controller_label": "string",
"device_key": 0,
"encrypted": false,
"is_vm_home": false,
"label": "string",
"source_disk_format": "SAME_AS_SOURCE",
"source_path": {
"datastore_id": "Datastore:datastore-16:ff4a23e7-2fed-4be0-be39-479ae372badd",
"datastore_name": "local-datastore",
"filename": "vmDisk1.vmdk",
"path": "/path/to/folder"
},
"source_storage_policy_id": "dsbrowser.defaultStoragePolicy",
"source_storage_policy_name": "string",
"supported_for_replication": false,
"vm_id": "VirtualMachine:vm-80:e594ad24-5f75-41e3-a276-88a2116dbed0"
}
]
}
Errors
Bad request - the server could not understand the request due to invalid syntax or invalid request body content
Unauthorized - the client must authenticate itself to get the requested response
Forbidden - not sufficient access rights to fulfill the request
Not Found - server cannot find the requested in URL resource
Internal server error - unexpected condition prevents fulfilling the request
Code Samples
PowerCLI Client SDK Example
cURL Command
Vendor Extensions
x-dr-permissions:
permissions: StorageProfile.View
x-dr-remote-site-connectivity-contract:
not-authenticated: DEPENDS_ON_PROVIDED_PARAMS
server-down: DEPENDS_ON_PROVIDED_PARAMS
