REST API - filter

vcenter datastore: filter spec

The filter_spec structure contains fields used to filter the results when listing datastores (see list). If multiple fields are specified, only datastores matching all of the fields match the filter.

Representations:

JSON
XML

{
    "datacenters": [
        "obj-103",
        "obj-103"
    ],
    "datastores": [
        "obj-103",
        "obj-103"
    ],
    "folders": [
        "obj-103",
        "obj-103"
    ],
    "names": [
        "string",
        "string"
    ],
    "types": [
        "VMFS",
        "VMFS"
    ]
}

<?xml version="1.0" ?>
<ns0:FilterSpec xmlns:ns0="http://vmware.com/vcenter/datastore" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <datacenters-array>
    <array-item>obj-103</array-item>
    <array-item>obj-103</array-item>
  </datacenters-array>
  <names-array>
    <array-item>string</array-item>
    <array-item>string</array-item>
  </names-array>
  <folders-array>
    <array-item>obj-103</array-item>
    <array-item>obj-103</array-item>
  </folders-array>
  <types-array>
    <array-item>VMFS</array-item>
    <array-item>VMFS</array-item>
  </types-array>
  <datastores-array>
    <array-item>obj-103</array-item>
    <array-item>obj-103</array-item>
  </datastores-array>
</ns0:FilterSpec>

Attributes:

Name	Type	Description
Optional
datastores	string[]	Identifiers of datastores that can match the filter. Optional. If unset or empty, datastores with any identifier match the filter.When clients pass a value of this structure as a parameter, the field must contain identifiers for the resource type: `Datastore`. When operations return a value of this structure as a result, the field will contain identifiers for the resource type: `Datastore`.
names	string[]	Names that datastores must have to match the filter (see vcenter.datastore.info.name). Optional. If unset or empty, datastores with any name match the filter.
types	string[]	Types that datastores must have to match the filter (see vcenter.datastore.summary.type). Optional. If unset or empty, datastores with any type match the filter.
folders	string[]	Folders that must contain the datastore for the datastore to match the filter. Optional. If unset or empty, datastores in any folder match the filter.When clients pass a value of this structure as a parameter, the field must contain identifiers for the resource type: `Folder`. When operations return a value of this structure as a result, the field will contain identifiers for the resource type: `Folder`.
datacenters	string[]	Datacenters that must contain the datastore for the datastore to match the filter. Optional. If unset or empty, datastores in any datacenter match the filter.When clients pass a value of this structure as a parameter, the field must contain identifiers for the resource type: `Datacenter`. When operations return a value of this structure as a result, the field will contain identifiers for the resource type: `Datacenter`.