1. Operations
  2. vcenter
  3. inventory
  4. datastore

vcenter inventory datastore: 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:

HTTP request

POST https://{server}/rest/com/vmware/vcenter/inventory/datastore?~action=find

Request Body Structure:

{
    "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>

Request Body Parameters:

Name Type Description
bold = required
datastores string[] Identifiers of the datastores for which information will be returned.

Response:

HTTP Status Code: 200

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>

Response Type:

Name Type Description
bold = required
value list 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.List of {"key": string, "value": info}
value[].key string
value[].value info Optional.
value[].value.type string Type of the datastore.

When clients pass a value of this structure as a parameter, the field must be one of Datastore or StoragePod. When operations return a value of this structure as a result, the field will be one of Datastore or StoragePod.

Errors:

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