VMware Cloud Director API - GET-DatastoresFromQuery
GET /admin/extension/datastores/query
- Operation:
- GET /admin/extension/datastores/query
- Description:
- Get a list of all datastores by using REST API General QueryHandler. This is read only list of datastores. If filter is provided it will be applied to the corresponding result set. Format determines the elements representation - referenceView or simpleView. Default format is referenceView.
- Since:
- 1.5
- Input parameters
-
- Consume media type(s):
- None
- Input type:
- None
- Query parameters
-
- Parameter
- filter
- Documentation
- Parameter
- sortAsc
- Documentation
- Parameter
- sortDesc
- Documentation
- Parameter
- format
- Documentation
- Parameter
- page
- Documentation
- Parameter
- pageSize
- Documentation
- Parameter
- offset
- Documentation
- Parameter
- fields
- Documentation
- Parameter
- links
- Documentation
- Output parameters
-
Returns OkResponse
- Produce media type(s):
-
application/vnd.vmware.vcloud.query.records+xml
application/vnd.vmware.vcloud.query.records+json
application/vnd.vmware.vcloud.query.idrecords+xml
application/vnd.vmware.vcloud.query.idrecords+json
application/vnd.vmware.vcloud.query.references+xml
application/vnd.vmware.vcloud.query.references+json
- Output type:
- ContainerType
- Examples
-
- Request
-
HTTP 1.1
GET /api/admin/extension/datastores/query?&filter=((moref==datastore-11;vcName==ConfigWizard Configured vCenter))&format=references
Headers:
x-vcloud-authorization: SIwgxt4VwQ7JI0Q408lLsNcXkS0xAFHZpdoIzGnPOv0=
Body:
- Response
-
HTTP/1.1 200 OK
Headers:
Content-Length: 1373
Content-Type: application/vnd.vmware.vcloud.query.references+xml; version=5.5
Vary: Accept-Encoding
Body:
<?xml version="1.0" encoding="UTF-8"?>
<DatastoreReferences xmlns="http://www.vmware.com/vcloud/v1.5" total="1" pageSize="25" page="1" name="datastore" type="application/vnd.vmware.vcloud.query.references+xml" href="https://vcloud.example.com/api/admin/extension/datastores/query?page=1&pageSize=25&format=references&filter=((moref==datastore-11;vcName==ConfigWizard%20Configured%20vCenter))" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.vmware.com/vcloud/v1.5 http://vcloud.example.com/api/v1.5/schema/master.xsd">
<Link rel="alternate" type="application/vnd.vmware.vcloud.query.records+xml" href="https://vcloud.example.com/api/admin/extension/datastores/query?page=1&pageSize=25&format=records&filter=((moref==datastore-11;vcName==ConfigWizard%20Configured%20vCenter))"/>
<Link rel="alternate" type="application/vnd.vmware.vcloud.query.idrecords+xml" href="https://vcloud.example.com/api/admin/extension/datastores/query?page=1&pageSize=25&format=idrecords&filter=((moref==datastore-11;vcName==ConfigWizard%20Configured%20vCenter))"/>
<DatastoreReference
type="application/vnd.vmware.admin.datastore+xml"
name="datastore1"
id="urn:vcloud:datastore:1d8a8c09-3c87-450f-8ba2-bff4d10a3b8a"
href="https://vcloud.example.com/api/admin/extension/datastore/1d8a8c09-3c87-450f-8ba2-bff4d10a3b8a"/>
</DatastoreReferences>