API Guide

],
"messages": [
{
"id": "string",
"message": "string",
"field_name": "string",
"messageParams": [
"string"
]
}
]
}
GET /telemetry/switch/rank/metric/{metric-
name}
Retrieves metrics for all switches in the topology. Returns switch information in descending order by the metric.
API
GET/telemetry/switch/rank/metric/{metric-name}
Description This API retrieves metrics for all switches in the topology. Returns switch information in descending order by the
metric. For example, for CPU utilization, this API returns switches in the topology in descending order.
Parameters
Table 83. API parameters
Filter name Description
metric-name *
required
string
(path)
Name of metric. See /telemetry/catalog for
supported metric names.
Responses 200 — Response for get switches ranked by metric
{
"data": [{
"entity_name": "sc2-t5-s4148-l4",
"entity_id": "2:51778771773521959",
"value": "32.0"
}, {
"entity_name": "sc2-t5-s4148-l3",
"entity_id": "2:51778771772669974",
"value": "17.0"
}, {
"entity_name": "sc2-t5-z9100-s2",
"entity_id": "2:51778771768737795",
"value": "3.0"
}]
}
400 — Invalid request
{
"new_object_id": "string",
"id": "string",
"message": "string",
"messageParams": [
"string"
],
"messages": [
{
"id": "string",
"message": "string",
176
Telemetry