Obtención de métricas de utilización de Load Balancer con la API de REST de Azure

Artículo
06/26/2024

Recopile el número de bytes procesados por una instancia de Standard Load Balancer durante un intervalo de tiempo mediante la API de REST de Azure.

La documentación de referencia completa y más ejemplos para la API de REST están disponibles en Referencia de REST de Azure Monitor.

Compilar la solicitud

Utilice la siguiente solicitud GET para recopilar la métrica de ByteCount desde un servicio Standard Load Balancer.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=ByteCount&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	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API de Azure Resource Manager, la CLI o en Azure Portal.
loadBalancerName	El nombre de Azure Load Balancer.
metric names	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	El intervalo de tiempo de la consulta. Es una cadena con el siguiente formato `startDateTime_ISO/endDateTime_ISO`. 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-05T03:00:00Z/2018-06-07T03:00:00Z",
    "interval": "PT1M",
    "value": [
        {
            "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/providers/Microsoft.Insights/metrics/ByteCount",
            "type": "Microsoft.Insights/metrics",
            "name": {
                "value": "ByteCount",
                "localizedValue": "Byte Count"
            },
            "unit": "Count",
            "timeseries": [
                {
                    "metadatavalues": [],
                    "data": [
                        {
                            "timeStamp": "2018-06-06T17:24:00Z",
                            "total": 1067921034.0
                        },
                        {
                            "timeStamp": "2018-06-06T17:25:00Z",
                            "total": 0.0
                        },
                        {
                            "timeStamp": "2018-06-06T17:26:00Z",
                            "total": 3781344.0
                        },
                    ]
                }
            ]
        }
    ],
    "namespace": "Microsoft.Network/loadBalancers",
    "resourceregion": "eastus"
}

Compartir vía