REST API - find

REST API - find

com.vmware.vcenter.inventory.datastore

The datastore service provides operations to retrieve information about datastores.

find

POST /com/vmware/vcenter/inventory/datastore?~action=find

Returns datastore information for the specified datastores. The key in the result key/value pairs is the datastore identifier and the value in the key/value pairs is the datastore information.
Request:
Representations:
{
    "datastores": [
        "obj-103",
        "obj-103"
    ]
}
<?xml version="1.0" ?>
<ns0:Find-Input xmlns:ns0="http://vmware.com/vcenter/inventory/datastore" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <datastores-array>
    <array-item>obj-103</array-item>
    <array-item>obj-103</array-item>
  </datastores-array>
</ns0:Find-Input>
POST /com/vmware/vcenter/inventory/datastore?~action=find
&datastores.1=obj-103
&datastores.2=obj-103

Parameters:
Name Type Required Description
datastores
 *
 List<ID> Yes Identifiers of the datastores for which information will be returned. Id of type Datastore.

Response:
Representations:
{
    "value": [
        {
            "key": "obj-103",
            "value": {
                "type": "string"
            }
        }
    ]
}
<?xml version="1.0" ?>
<ns0:Find-Result xmlns:ns0="http://vmware.com/vcenter/inventory/datastore" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <value-array>
    <array-item>
      <value>
        <type>string</type>
      </value>
      <key>obj-103</key>
    </array-item>
  </value-array>
</ns0:Find-Result>

Parameters:
Name Type Required Description
result Map<ID, Optional<info>> Yes Datastore information for the specified datastores. The key in the result key/value pairs is the datastore identifier and the value in the key/value pairs is the datastore information. Id of type Datastore.

Errors:
Type Description HTTP Status Code
not_found if no datastore can be found for one or more of the datastore identifiers in datastores 404

Copyright © 2014. All Rights Reserved.