View a markdown version of this page

ListRules - Servicio administrado por Amazon para Prometheus

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

ListRules

ListRules recupera información sobre las reglas configuradas en el espacio de trabajo.

Verbos HTTP válidos:

GET

URI válidos:

/workspaces/workspaceId/api/v1/rules

Parámetros de consulta de URL:

type=<alert|record>Devuelve solo las reglas de alerta (por ejemplo,type=alert) o las reglas de registro (por ejemplo,). type=record Cuando el parámetro está ausente o vacío, no se realiza ningún filtrado. Opcional

rule_name[]=<string>Filtra las reglas con los nombres proporcionados. Cuando se proporcionan varios filtros, el nombre de la regla debe cumplir con al menos uno de los filtros indicados. Opcional

rule_group[]=<string>Filtra los grupos de reglas con los nombres proporcionados. Cuando se proporcionan varios filtros, el nombre del grupo de reglas debe cumplir con al menos uno de los filtros indicados. Opcional

file[]=<string>Filtra los espacios de nombres de los grupos de reglas con los nombres proporcionados. Cuando se proporcionan varios filtros, el nombre del espacio de nombres del grupo de reglas debe cumplir al menos uno de los filtros indicados. Opcional

exclude_alerts=<true|false>Filtra las reglas sin ninguna alerta activa cuando se establece en. true Opcional

match[]=<series_selector>Solo devuelven las reglas que tienen etiquetas configuradas que cumplen con los selectores de etiquetas. Si se repite el parámetro, se devuelven las reglas que coinciden con cualquiera de los conjuntos de selectores de etiquetas. Tenga en cuenta que la coincidencia se encuentra en las etiquetas de la definición de cada regla, no en los valores después de la expansión de la plantilla (en el caso de las reglas de alerta). Opcional

group_limit=<number>Número máximo de grupos de reglas devueltos en una sola respuesta. En las siguientes solicitudes de paginación, utilice la groupNextToken propiedad de esta respuesta para establecer el group_next_token parámetro. Opcional

group_next_token=<string>El token de paginación devuelto en la solicitud anterior cuando se estableció la group_limit propiedad. Este token se usa para paginar de forma iterativa los grupos de reglas restantes. Opcional

Solicitud de ejemplo

GET /workspaces/ws-b226cc2a-a446-46a9-933a-ac50479a5568/api/v1/rules HTTP/1.1
Content-Length: 0, 
Authorization: AUTHPARAMS
X-Amz-Date: 20201201T193725Z
User-Agent: Grafana/8.1.0

Respuesta de ejemplo

HTTP/1.1 200 OK
x-amzn-RequestId: 12345678-abcd-4442-b8c5-262b45e9b535
Content-Length: 423
Connection: keep-alive
Date: Tue, 01 Dec 2020 19:37:25 GMT
Content-Type: application/json
Server: amazon
vary: Origin

{
    "status": "success",
    "data": {
        "groups": [
            {
                "name": "test-1.rules",
                "file": "test-rules",
                "rules": [
                    {
                        "name": "record:1",
                        "query": "sum(rate(node_cpu_seconds_total[10m:1m]))",
                        "labels": {},
                        "health": "ok",
                        "lastError": "",
                        "type": "recording",
                        "lastEvaluation": "2021-10-21T21:22:34.429565909Z",
                        "evaluationTime": 0.001005399
                    }
                ],
                "interval": 60,
                "lastEvaluation": "2021-10-21T21:22:34.429563992Z",
                "evaluationTime": 0.001010504
            }
        ]
    },
    "errorType": "",
    "error": ""
}