Получение метрик использования виртуальной машины с помощью REST API
Область применения: ✔️ Виртуальные машины Linux ✔️ Гибкие масштабируемые наборы
В этом примере показано, как получить использование ЦП для виртуальной машины Linux с помощью REST API Azure.
Полные справочные материалы и примеры REST API доступны в справочной статье по REST Azure Monitor.
Создание запроса
Используйте следующий запрос GET для сбора метрик процента ЦП из виртуальной машины.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU×pan=2018-06-05T03:00:00Z/2018-06-07T03:00:00Z
Заголовки запросов
Ниже приведены обязательные заголовки.
Заголовок запроса | Description |
---|---|
Content-Type (Тип контента). | Обязательный. Задайте значение application/json . |
Авторизация. | Обязательный. Задайте допустимый маркер доступа Bearer . |
Параметры универсального кода ресурса (URI)
Имя | Описание |
---|---|
subscriptionId | Идентификатор подписки Azure. Если у вас несколько подписок, см. раздел Использование нескольких подписок. |
resourceGroupName | Имя группы ресурсов Azure, связанное с ресурсом. Вы можете получить это значение из API-интерфейса Azure Resource Manager, CLI или портала. |
vmname | Имя виртуальной машины. |
metricnames | Разделенный запятыми список допустимых метрик Load Balancer. |
api-version | Версия API для использования в запросе. В этом документе рассматривается API версии 2018-01-01 , которая включена в приведенный выше URL-адрес. |
timespan | Строка, в следующем формате startDateTime_ISO/endDateTime_ISO , определяет диапазон времени для возвращаемых метрик. Этот необязательный параметр имеет значение для возврата суточных данных в примере. |
Текст запроса
Для этой операции текст запроса не требуется.
Обработка ответа
Код состояния 200 возвращается в том случае, если успешно возвращается список значений метрик. Полный список кодов ошибок доступен в справочной документации.
Пример отклика
{
"cost": 0,
"timespan": "2018-06-08T23:48:10Z/2018-06-09T00:48:10Z",
"interval": "PT1M",
"value": [
{
"id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU",
"type": "Microsoft.Insights/metrics",
"name": {
"value": "Percentage CPU",
"localizedValue": "Percentage CPU"
},
"unit": "Percent",
"timeseries": [
{
"metadatavalues": [],
"data": [
{
"timeStamp": "2018-06-08T23:48:00Z",
"average": 0.44
},
{
"timeStamp": "2018-06-08T23:49:00Z",
"average": 0.31
},
{
"timeStamp": "2018-06-08T23:50:00Z",
"average": 0.29
},
{
"timeStamp": "2018-06-08T23:51:00Z",
"average": 0.29
},
{
"timeStamp": "2018-06-08T23:52:00Z",
"average": 0.285
} ]
} ]
} ]
}