Obtener métricas de utilización de máquina virtual mediante la API de REST

  • Artículo

Se aplica a: ✔️ máquinas virtuales Linux ✔️ conjuntos de escalado flexibles

En este ejemplo se muestra cómo recuperar la utilización de CPU de una máquina virtual Linux mediante la API REST de Azure.

La documentación de referencia completa y los ejemplos para la API de REST están disponibles en el artículo de referencia de REST de Azure Monitor.

Compilar la solicitud

Utilice la siguiente solicitud GET para recopilar la métrica de porcentaje de CPU desde una máquina virtual.

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

Encabezados de solicitud

Los siguientes encabezados son obligatorios:

Encabezado de solicitud Descripción
Content-Type: Necesario. Establézcalo en application/json.
Authorization: Necesario. Establézcalo en un token de acceso Bearer válido.

Parámetros del identificador URI

Nombre Descripción
subscriptionId El id. de suscripción que identifica una suscripción de Azure. Si tiene varias suscripciones, consulte Trabajo con varias suscripciones.
resourceGroupName El nombre del grupo de recursos de Azure asociado al recurso. Puede obtener este valor de la API Azure Resource Manager, la CLI o el portal.
vmname El nombre de la máquina virtual de Azure.
metricnames Lista separada por comas de métricas válidas de Load Balancer.
api-version La versión de API que se usará para la solicitud.

En este documento se describe la versión 2018-01-01 de la API que se incluye en la dirección URL anterior.
timespan Cadena con el siguiente formato startDateTime_ISO/endDateTime_ISO que define el intervalo de tiempo de las métricas devueltas. Este parámetro opcional se establece para devolver los datos recopilados durante un día en el ejemplo.
   

Cuerpo de la solicitud

No se necesita ningún cuerpo de solicitud para esta operación.

Control de la respuesta

Cuando la lista de valores de métricas se devuelve correctamente, se devuelve el código de estado 200. Una lista completa de códigos de error está disponible en la documentación de referencia.

Respuesta de ejemplo

{
    "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
                        } ]
                } ]
        } ]
}