Lists the metric values for multiple resources.
Path parameters
The subscription identifier for the resources in this batch.
Query parameters
The API version to use for this operation.
The start time of the query. It is a string in the format 'yyyy-MM-ddTHH:mm:ss.fffZ'. If you have specified the endtime parameter, then this parameter is required. If only starttime is specified, then endtime defaults to the current time. If no time interval is specified, the default is 1 hour.
The end time of the query. It is a string in the format 'yyyy-MM-ddTHH:mm:ss.fffZ'.
The interval (i.e. timegrain) of the query in ISO 8601 duration format. Defaults to PT1M. Special case for 'FULL' value that returns single datapoint for entire time span requested. Examples: PT15M, PT1H, P1D, FULL
Metric namespace that contains the requested metric names.
The names of the metrics (comma separated) to retrieve.
The list of aggregation types (comma separated) to retrieve. Examples: average, minimum, maximum
The maximum number of records to retrieve per resource ID in the request. Valid only if filter is specified. Defaults to 10.
The aggregation to use for sorting results and the direction of the sort. Only one order can be specified. Examples: sum asc
The filter is used to reduce the set of metric data returned.<br>Example:<br>Metric contains metadata A, B and C.<br>- Return all time series of C where A = a1 and B = b1 or b2<br>filter=A eq ‘a1’ and B eq ‘b1’ or B eq ‘b2’ and C eq ‘*’<br>- Invalid variant:<br>filter=A eq ‘a1’ and B eq ‘b1’ and C eq ‘*’ or B = ‘b2’<br>This is invalid because the logical or operator cannot separate two different metadata names.<br>- Return all time series where A = a1, B = b1 and C = c1:<br>filter=A eq ‘a1’ and B eq ‘b1’ and C eq ‘c1’<br>- Return all time series where A = a1<br>filter=A eq ‘a1’ and B eq ‘’ and C eq ‘’.
Dimension name(s) to rollup results by. For example if you only want to see metric values with a filter like 'City eq Seattle or City eq Tacoma' but don't want to see separate values for each city, you can specify 'RollUpBy=City' to see the results for Seattle and Tacoma rolled up into one timeseries.
Request body
Response
The request has succeeded.
Changes
Changed in 4 of the 4 revisions of this API.711
- ●
the optional response header
x-ms-error-coderemoved for the statusdefaultoptional-response-header-removed
- ○
api operation id
MetricsBatch_Batchremoved and replaced withBatchapi-operation-id-removed
- ○
api tag
Metricsremovedapi-tag-removed
- ○
added the new optional
queryrequest parameteraggregationnew-optional-request-parameter
- ○
added the new optional
queryrequest parameterorderbynew-optional-request-parameter
- ○
added the new optional
queryrequest parameterrollupbynew-optional-request-parameter
- ○
added the new optional
queryrequest parametertopnew-optional-request-parameter
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ●
- ●
deleted the
queryrequest parameteraggregationrequest-parameter-removed
- ●
deleted the
queryrequest parameterorderbyrequest-parameter-removed
- ●
deleted the
queryrequest parametertoprequest-parameter-removed
- ●
- ●
deleted the
queryrequest parameterendtimerequest-parameter-removed
- ●
deleted the
queryrequest parameterstarttimerequest-parameter-removed
- ○
api operation id
MetricsBatch_Batchremoved and replaced withMetrics_Batchapi-operation-id-removed
- ○
added the new optional
queryrequest parametertimespannew-optional-request-parameter
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ●
- ●
deleted the
queryrequest parametertimespanrequest-parameter-removed
- ○
api operation id
Metrics_Batchremoved and replaced withMetricsBatch_Batchapi-operation-id-removed
- ○
added the new optional
queryrequest parameterendtimenew-optional-request-parameter
- ○
added the new optional
queryrequest parameterstarttimenew-optional-request-parameter
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ●