v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-142381,278956.3 KB

Lists the values reported for an IoT Device Defender metric (device-side metric, cloud-side metric, or custom metric) by the given thing during the specified time period.

get/metric-values#thingName&metricName&startTime&endTime

Query parameters

thingNamestring required

The name of the thing for which security profile metric values are returned.

metricNamestring required

The name of the security profile metric for which values are returned.

dimensionNamestring

The dimension name.

dimensionValueOperator'IN' | 'NOT_IN'

The dimension value operator.

startTimestring date-time required

The start of the time period for which metric values are returned.

endTimestring date-time required

The end of the time period for which metric values are returned.

maxResultsinteger

The maximum number of results to return at one time.

nextTokenstring

The token for the next set of results.

Response

Success

nextTokenstring

A token that can be used to retrieve the next set of results, or <code>null</code> if there are no additional results.