DatastoresResource


List datastores of a machine


GET https://example.com/api/admin/datacenters/{datacenter}/racks/{rack}/machines/{machine}/datastores

Roles : [ROLE_PHYS_DC_RETRIEVE_DETAILS]

Accept : datastores

Example

Refresh datastores of a machine


Refreshes the list of datastores from the physical machine.

GET https://example.com/api/admin/datacenters/{datacenter}/racks/{rack}/machines/{machine}/datastores/action/refresh

Roles : [ROLE_PHYS_DC_ALLOW_MODIFY_SERVERS]

Example

Get a datastore of a machine


GET https://example.com/api/admin/datacenters/{datacenter}/racks/{rack}/machines/{machine}/datastores/{datastore}

Roles : [ROLE_PHYS_DC_RETRIEVE_DETAILS]

Accept : datastore

Example

Update a datastore of a machine


PUT https://example.com/api/admin/datacenters/{datacenter}/racks/{rack}/machines/{machine}/datastores/{datastore}

Roles : [ROLE_PHYS_DC_ALLOW_MODIFY_SERVERS]

Content-Type : datastore Accept : datastore

Error Codes

  • DATASTORE-0 - The requested datastore does not exist
  • DATASTORE-5 - Duplicate root path for the datastore
  • DSTIER-2 - Cannot modify the datastore tier of a datastore with deployed virtual machines

Example

List hard disks on a datastore of a machine


Retrieve all the disks on a datastore of a machine.

GET https://example.com/api/admin/datacenters/{datacenter}/racks/{rack}/machines/{machine}/datastores/{datastore}/disks

Roles : [ROLE_PHYS_DC_RETRIEVE_DETAILS]

Parameter Type Default Value Description
startwith Integer 0 The first element to be retrieved of the filtered search
limit Integer 25 The number of entities to retrieve
by String name Order by
has String If present filter to apply in the search.
asc Boolean true If the value of the 'by' parameter must be sorted in ascending order (true) or descending order (false)

Accept : harddisks

Example