Get all datastores across registered hypervisor managers.

get/virtualization/v1beta1/datastores

List all the datastores across registered hypervisor managers.

Securitybearer
Request
query Parameters
offset
integer

The number of items to skip before starting to collect the result set

limit
integer <int32> [ 1 .. 1000 ]
Default: 20

The numbers of items to return

filter
string

The filter query parameter is used to filter the set of resources returned in the response. The returned set of resources must match the criteria in the filter query parameter.

A comparison compares a property name to a literal. The following comparisons are supported:

  • “eq” : Is a property equal to value. Valid for number, boolean and string properties.
  • “ne” : Is a property not equal to value. Valid for number, boolean and string properties.
  • “gt” : Is a property greater than a value. Valid for number or string timestamp properties.
  • “lt” : Is a property less than a value. Valid for number or string timestamp properties
  • “in” : Is a value in a property (that is an array of strings)

Examples:

  • GET /virtualization/v1beta1/datastores?filter="datastoreType eq VMFS"
  • GET /virtualization/v1beta1/datastores?filter="datastoreType eq VMFS and status eq ERROR"

Filters are supported on the following attributes:

  • status
  • state
  • appType
  • hypervisorManagerInfo/name
  • hypervisorManagerInfo/displayName
  • hypervisorManagerInfo/id
  • hostsInfo/id
  • hostsInfo/name
  • hostsInfo/displayName
  • clusterInfo/id
  • clusterInfo/name
  • clusterInfo/displayName
  • protectionJobInfo/protectionPolicyInfo/id
  • protectionJobInfo/protectionPolicyInfo/name
  • vmProtectionGroupsInfo/id
  • vmProtectionGroupsInfo/name
  • volumesInfo/id
  • volumesInfo/storageSystemInfo/id
  • volumesInfo/storageSystemInfo/serialNumber
  • volumesInfo/storageSystemInfo/name
  • volumesInfo/storageSystemInfo/vendorName
  • volumesInfo/storageFolderInfo/id
  • volumesInfo/storageFolderInfo/name
  • volumesInfo/storagePoolInfo/id
  • volumesInfo/storagePoolInfo/name
  • datastoreType
  • createdAt
  • name
  • services
  • allowedOperations
  • capacityInBytes
  • capacityFree
  • displayName
  • replicationInfo/name
  • replicationInfo/id
  • hciClusterUuid
sort
string

A comma separated list of properties to sort by, followed by a direction indicator ("asc" or "desc"). If no direction indicator is specified, the default order is ascending.

select
string

The select query parameter is used to limit the properties returned with a resource or collection-level GET. Multiple properties can be listed to be returned. The server must only return the set of properties requested by the client. The property “select” is the name of the select query parameter; its value is the list of properties to return separated by commas.

Responses
200

Success

400

Bad Request

401

Unauthorized request

403

Forbidden

500

Internal / unexpected error

Request samples 
Response samples 
application/json
{
  • "count": 0,
  • "items": [
    ],
  • "offset": 0,
  • "total": 0
}