This API has a deprecated equivalent from v7.0U1.

Find Datastore

Returns datastore information for the specified datastores. The key in the result map is the datastore identifier and the value in the map is the datastore information. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource Datastore referenced by the parameter datastores requires System.Read.

Request

URL

GET

https://{api_host}/api/vcenter/inventory/datastore

Copy

Query Parameters

array of string

datastores Required

Identifiers of the datastores for which information will be returned. The parameter must contain identifiers for the resource type: Datastore.

Header Parameters

string

vmware-api-session-id Required

Required session ID, acquired from Create Session API under CIS product

vmware-api-session-id example

"b00db39f948d13ea1e59b4d6fce56389"

Authentication

This operation uses the following authentication methods.

api_key

Response

Response Body

200 OK returns map of InventoryDatastoreInfo of type application/json

Datastore information for the specified datastores. The key in the result map is the datastore identifier and the value in the map is the datastore information. The key in the result map will be an identifier for the resource type: Datastore.

{
	"type": "string"
}

string

type Required

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

Error

404

com.vmware.vapi.std.errors.not_found : if no datastore can be found for one or more of the datastore identifiers in datastores

Error

default

‘Default’ means this response is used for all HTTP codes that are not covered individually for this operation.

Code Samples

PowerCLI Client SDK Example

Invoke-GetInventoryDatastore -Datastores "MyDatastores"

cURL Command

curl -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" https://{api_host}/api/vcenter/inventory/datastore?datastores=string

Vendor Extensions

This operation contains the following vendor extensions defined in the spec:

x-vmw-doc-deprecated-method: post
x-vmw-doc-deprecated-path: /rest/com/vmware/vcenter/inventory/datastore?~action=find
x-vmw-doc-operation: find

Availability

Added in 7.0U2