# Data Object - PerfQuerySpec(vim.PerformanceManager.QuerySpec)

Parameter to
  QueryPerf, QueryPerfComposite
Extends
  DynamicData
See also
  PerfMetricId
Since
  2.0

## Data Object Description

This data object specifies the query parameters, including the managed object reference to the target entity for statistics retrieval.

- If the optional intervalId is omitted, the metrics are returned in their originally sampled interval.
  - When an intervalId is specified, the server tries to summarize the information for the specified intervalId. However, if that interval does not exist or has no data, the server summarizes the information using the best interval available.
- If the range between startTime and endTime crosses multiple sample interval periods, the result contains data from the longest interval in the period.

Properties

Name | Type | Description
--- | --- | ---
endTime* | xsd:dateTime | The time up to which statistics are retrieved. Corresponds to server time. When endTime is omitted, the returned result includes up to the most recent metric value. When an endTime is specified, the returned samples include the sample at endTime.
entity | ManagedObjectReference | The managed object whose performance statistics are being queried.
format* | xsd:string | The format to be used while returning the statistics. See PerfFormat
intervalId* | xsd:int | The interval (samplingPeriod), in seconds, for the performance statistics. For aggregated information, use one of the historical intervals for this property. See PerfInterval for more information. To obtain the greatest detail, use the provider’s refreshRate for this property.
maxSample* | xsd:int | Limits the number of samples returned. Defaults to the most recent sample (or samples), unless a time range is specified. Use this property only in conjunction with the intervalId to obtain real-time statistics (set the intervalId to the refreshRate. This property is ignored for historical statistics, and is not valid for the QueryPerfComposite operation.
metricId* | PerfMetricId[] | The performance metrics to be retrieved. This property is required for the QueryPerfComposite operation.
startTime* | xsd:dateTime | The server time from which to obtain counters. If not specified, defaults to the first available counter. When a startTime is specified, the returned samples do not include the sample at startTime.
Properties inherited from DynamicData
None

*Need not be set
Show WSDL type definition
<complexType xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="PerfQuerySpec"> <complexContent> <extension base="vsan:DynamicData"> <sequence> <element name="entity" type="vsan:ManagedObjectReference"/> <element name="startTime" type="xsd:dateTime" minOccurs="0"/> <element name="endTime" type="xsd:dateTime" minOccurs="0"/> <element name="maxSample" type="xsd:int" minOccurs="0"/> <element name="metricId" type="vsan:PerfMetricId" minOccurs="0" maxOccurs="unbounded"/> <element name="intervalId" type="xsd:int" minOccurs="0"/> <element name="format" type="xsd:string" minOccurs="0"/> </sequence> </extension> </complexContent> </complexType>