Получение метрик использования виртуальной машины с помощью REST API

Статья
01/30/2024

Область применения: ✔️ Виртуальные машины 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&timespan=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
                        } ]
                } ]
        } ]
}

Поделиться через