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"
]
}
"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>
<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"
}
}
]
}
"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>
<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 |