Scheduled Query Rules - Update

Referencia

Servicio:: Monitor

Versión de la API:: 2021-08-01

Actualice una regla de consulta programada.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/scheduledQueryRules/{ruleName}?api-version=2021-08-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
ruleName	path	True	string	Nombre de la regla.
subscriptionId	path	True	string	Identificador de la suscripción de destino.
api-version	query	True	string	Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre	Tipo	Description
properties.actions	Actions	Acciones que se invocarán cuando se active la alerta.
properties.autoMitigate	boolean	Marca que indica si la alerta se debe resolver automáticamente o no. El valor predeterminado es true. Solo es relevante para las reglas del tipo LogAlert.
properties.checkWorkspaceAlertsStorageConfigured	boolean	Marca que indica si esta regla de consulta programada debe almacenarse en el almacenamiento del cliente. El valor predeterminado es false. Solo es relevante para las reglas del tipo LogAlert.
properties.criteria	ScheduledQueryRuleCriteria	Criterios de regla que definen las condiciones de la regla de consulta programada.
properties.description	string	Descripción de la regla de consulta programada.
properties.displayName	string	Nombre para mostrar de la regla de alertas
properties.enabled	boolean	Marca que indica si esta regla de consulta programada está habilitada. El valor debe ser true o false
properties.evaluationFrequency	string	Frecuencia con la que se evalúa la regla de consulta programada representada en formato de duración ISO 8601. Relevante y solo es necesario para las reglas del tipo LogAlert.
properties.muteActionsDuration	string	Silenciar acciones durante el período de tiempo elegido (en formato de duración ISO 8601) después de que se desencadene la alerta. Solo es relevante para las reglas del tipo LogAlert.
properties.overrideQueryTimeRange	string	Si se especifica, invalida el intervalo de tiempo de consulta (el valor predeterminado es WindowSize*NumberOfEvaluationPeriods). Solo es relevante para las reglas del tipo LogAlert.
properties.scopes	string[]	La lista de identificadores de recurso a la que se limita esta regla de consulta programada.
properties.severity	AlertSeverity	Gravedad de la alerta. Debe ser un entero entre [0-4]. El valor de 0 es más grave. Relevante y solo es necesario para las reglas del tipo LogAlert.
properties.skipQueryValidation	boolean	Marca que indica si se debe validar o no la consulta proporcionada. El valor predeterminado es false. Solo es relevante para las reglas del tipo LogAlert.
properties.targetResourceTypes	string[]	Lista del tipo de recurso de los recursos de destino en los que se crea o actualiza la alerta. Por ejemplo, si el ámbito es un grupo de recursos y targetResourceTypes es Microsoft.Compute/virtualMachines, se desencadenará una alerta diferente para cada máquina virtual del grupo de recursos que cumpla los criterios de alerta. Solo es relevante para las reglas del tipo LogAlert.
properties.windowSize	string	Período de tiempo (en formato de duración ISO 8601) en el que se ejecutará la consulta de alerta (tamaño de intervalo). Relevante y solo es necesario para las reglas del tipo LogAlert.
tags	object	Etiquetas del recurso

Respuestas

Nombre	Tipo	Description
200 OK	ScheduledQueryRuleResource	Solicitud correcta para actualizar una regla de consulta programada
Other Status Codes	ErrorContract	Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

Create or update a scheduled query rule

Solicitud de ejemplo

HTTP

PATCH https://management.azure.com/subscriptions/dd4bfc94-a096-412b-9c43-4bd13e35afbc/resourceGroups/QueryResourceGroupName/providers/Microsoft.Insights/scheduledQueryRules/heartbeat?api-version=2021-08-01

{
  "properties": {
    "enabled": false
  }
}

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/dd4bfc94-a096-412b-9c43-4bd13e35afbc/resourcegroups/QueryResourceGroupName/providers/microsoft.insights/scheduledqueryrules/heartbeat",
  "name": "heartbeat",
  "type": "microsoft.insights/scheduledqueryrules",
  "location": "eastus",
  "tags": {},
  "properties": {
    "description": "Health check rule",
    "severity": 4,
    "enabled": false,
    "evaluationFrequency": "PT5M",
    "scopes": [
      "/subscriptions/aaf177ed-1330-a9f2-80ea-fd3d7783b147"
    ],
    "targetResourceTypes": [
      "Microsoft.Compute/virtualMachines"
    ],
    "windowSize": "PT10M",
    "criteria": {
      "allOf": [
        {
          "query": "Heartbeat",
          "timeAggregation": "Count",
          "dimensions": [],
          "operator": "GreaterThan",
          "threshold": 360,
          "failingPeriods": {
            "numberOfEvaluationPeriods": 1,
            "minFailingPeriodsToAlert": 1
          }
        }
      ]
    },
    "muteActionsDuration": "PT30M",
    "actions": {
      "actionGroups": [
        "/subscriptions/1cf177ed-1330-4692-80ea-fd3d7783b147/resourcegroups/sqrapi/providers/microsoft.insights/actiongroups/myactiongroup"
      ],
      "customProperties": {
        "key11": "value11",
        "key12": "value12"
      }
    },
    "autoMitigate": true,
    "isWorkspaceAlertsStorageConfigured": true,
    "checkWorkspaceAlertsStorageConfigured": true,
    "skipQueryValidation": true
  }
}

Definiciones

Nombre	Description
Actions	Acciones que se invocarán cuando se active la alerta.
AlertSeverity	Gravedad de la alerta. Debe ser un entero entre [0-4]. El valor de 0 es más grave. Relevante y solo es necesario para las reglas del tipo LogAlert.
Condition	Condición de la regla de consulta programada.
conditionOperator	Operador criteria. Relevante y solo es necesario para las reglas del tipo LogAlert.
createdByType	Tipo de identidad que creó el recurso.
Dimension	División de dimensiones y definición de filtrado
dimensionOperator	Operador para valores de dimensión
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorContract	Describe el formato de respuesta de error.
ErrorResponse	Respuesta de error
FailingPeriods	Número mínimo de infracciones necesarias en la ventana de tiempo de búsqueda seleccionada necesaria para generar una alerta. Solo es relevante para las reglas del tipo LogAlert.
Kind	Indica el tipo de regla de consulta programada. El valor predeterminado es LogAlert.
ScheduledQueryRuleCriteria	Criterios de regla que definen las condiciones de la regla de consulta programada.
ScheduledQueryRuleResource	Recurso de regla de consulta programada.
ScheduledQueryRuleResourcePatch	Recurso de regla de consulta programada para operaciones de revisión.
systemData	Metadatos relacionados con la creación y la última modificación del recurso.
timeAggregation	Tipo de agregación. Relevante y solo es necesario para las reglas del tipo LogAlert.

Actions

Acciones que se invocarán cuando se active la alerta.

Nombre	Tipo	Description
actionGroups	string[]	Identificadores de recurso del grupo de acciones que se invocarán cuando se active la alerta.
customProperties	object	Propiedades de una carga de alerta.

AlertSeverity

Gravedad de la alerta. Debe ser un entero entre [0-4]. El valor de 0 es más grave. Relevante y solo es necesario para las reglas del tipo LogAlert.

Nombre	Tipo	Description
0	Integer
1	Integer
2	Integer
3	Integer
4	Integer

Condition

Condición de la regla de consulta programada.

Nombre	Tipo	Description
dimensions	Dimension[]	Lista de condiciones de dimensiones
failingPeriods	FailingPeriods	Número mínimo de infracciones necesarias en la ventana de tiempo de búsqueda seleccionada necesaria para generar una alerta. Solo es relevante para las reglas del tipo LogAlert.
metricMeasureColumn	string	Columna que contiene el número de medida de métrica. Solo es relevante para las reglas del tipo LogAlert.
metricName	string	Nombre de la métrica que se va a enviar. Relevante y solo se requiere para las reglas del tipo LogToMetric.
operator	conditionOperator	Operador criteria. Relevante y solo es necesario para las reglas del tipo LogAlert.
query	string	Alerta de consulta de registro
resourceIdColumn	string	Columna que contiene el identificador de recurso. El contenido de la columna debe tener el formato URI como identificador de recurso. Solo es relevante para las reglas del tipo LogAlert.
threshold	number	el valor de umbral de criterios que activa la alerta. Relevante y solo es necesario para las reglas del tipo LogAlert.
timeAggregation	timeAggregation	Tipo de agregación. Relevante y solo es necesario para las reglas del tipo LogAlert.

conditionOperator

Operador criteria. Relevante y solo es necesario para las reglas del tipo LogAlert.

Nombre	Tipo	Description
Equals	string
GreaterThan	string
GreaterThanOrEqual	string
LessThan	string
LessThanOrEqual	string

createdByType

Tipo de identidad que creó el recurso.

Nombre	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Dimension

División de dimensiones y definición de filtrado

Nombre	Tipo	Description
name	string	Nombre de la dimensión
operator	dimensionOperator	Operador para valores de dimensión
values	string[]	Lista de valores de dimensión

dimensionOperator

Operador para valores de dimensión

Nombre	Tipo	Description
Exclude	string
Include	string

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorContract

Describe el formato de respuesta de error.

Nombre	Tipo	Description
error	ErrorResponse	Respuesta de error Los detalles del error.

ErrorResponse

Respuesta de error

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorResponse[]	Los detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

FailingPeriods

Número mínimo de infracciones necesarias en la ventana de tiempo de búsqueda seleccionada necesaria para generar una alerta. Solo es relevante para las reglas del tipo LogAlert.

Nombre	Tipo	Valor predeterminado	Description
minFailingPeriodsToAlert	integer	1	Número de infracciones para desencadenar una alerta. Debe ser menor o igual que numberOfEvaluationPeriods. El valor predeterminado es 1.
numberOfEvaluationPeriods	integer	1	Número de puntos de búsqueda agregados. La ventana de tiempo de búsqueda se calcula en función de la granularidad de agregación (windowSize) y del número seleccionado de puntos agregados. El valor predeterminado es 1.

Kind

Indica el tipo de regla de consulta programada. El valor predeterminado es LogAlert.

Nombre	Tipo	Description
LogAlert	string
LogToMetric	string

ScheduledQueryRuleCriteria

Criterios de regla que definen las condiciones de la regla de consulta programada.

Nombre	Tipo	Description
allOf	Condition[]	Lista de condiciones que se van a evaluar en los ámbitos especificados

ScheduledQueryRuleResource

Recurso de regla de consulta programada.

Nombre	Tipo	Description
etag	string	El campo etag no es obligatorio. Si se proporciona en el cuerpo de la respuesta, también debe proporcionarse como encabezado según la convención de etag normal. Las etiquetas de entidad se usan para comparar dos o más entidades del mismo recurso solicitado. HTTP/1.1 usa etiquetas de entidad en el etag (sección 14.19), If-Match (sección 14.24), If-None-Match (sección 14.26) y If-Range (sección 14.27) campos de encabezado.
id	string	Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	Kind	Indica el tipo de regla de consulta programada. El valor predeterminado es LogAlert.
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso.
properties.actions	Actions	Acciones que se invocarán cuando se active la alerta.
properties.autoMitigate	boolean	Marca que indica si la alerta se debe resolver automáticamente o no. El valor predeterminado es true. Solo es relevante para las reglas del tipo LogAlert.
properties.checkWorkspaceAlertsStorageConfigured	boolean	Marca que indica si esta regla de consulta programada debe almacenarse en el almacenamiento del cliente. El valor predeterminado es false. Solo es relevante para las reglas del tipo LogAlert.
properties.createdWithApiVersion	string	Versión de api usada al crear esta regla de alerta
properties.criteria	ScheduledQueryRuleCriteria	Criterios de regla que definen las condiciones de la regla de consulta programada.
properties.description	string	Descripción de la regla de consulta programada.
properties.displayName	string	Nombre para mostrar de la regla de alertas
properties.enabled	boolean	Marca que indica si esta regla de consulta programada está habilitada. El valor debe ser true o false
properties.evaluationFrequency	string	Frecuencia con la que se evalúa la regla de consulta programada representada en formato de duración ISO 8601. Relevante y solo es necesario para las reglas del tipo LogAlert.
properties.isLegacyLogAnalyticsRule	boolean	True si la regla de alertas es una regla heredada de Log Analytics
properties.isWorkspaceAlertsStorageConfigured	boolean	Marca que indica si esta regla de consulta programada se ha configurado para almacenarse en el almacenamiento del cliente. El valor predeterminado es false.
properties.muteActionsDuration	string	Silenciar acciones durante el período de tiempo elegido (en formato de duración ISO 8601) después de que se desencadene la alerta. Solo es relevante para las reglas del tipo LogAlert.
properties.overrideQueryTimeRange	string	Si se especifica, invalida el intervalo de tiempo de consulta (el valor predeterminado es WindowSize*NumberOfEvaluationPeriods). Solo es relevante para las reglas del tipo LogAlert.
properties.scopes	string[]	La lista de identificadores de recurso a la que se limita esta regla de consulta programada.
properties.severity	AlertSeverity	Gravedad de la alerta. Debe ser un entero entre [0-4]. El valor de 0 es más grave. Relevante y solo es necesario para las reglas del tipo LogAlert.
properties.skipQueryValidation	boolean	Marca que indica si se debe validar o no la consulta proporcionada. El valor predeterminado es false. Solo es relevante para las reglas del tipo LogAlert.
properties.targetResourceTypes	string[]	Lista del tipo de recurso de los recursos de destino en los que se crea o actualiza la alerta. Por ejemplo, si el ámbito es un grupo de recursos y targetResourceTypes es Microsoft.Compute/virtualMachines, se desencadenará una alerta diferente para cada máquina virtual del grupo de recursos que cumpla los criterios de alerta. Solo es relevante para las reglas del tipo LogAlert.
properties.windowSize	string	Período de tiempo (en formato de duración ISO 8601) en el que se ejecutará la consulta de alerta (tamaño de intervalo). Relevante y solo es necesario para las reglas del tipo LogAlert.
systemData	systemData	SystemData de ScheduledQueryRule.
tags	object	Etiquetas del recurso.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ScheduledQueryRuleResourcePatch

Recurso de regla de consulta programada para operaciones de revisión.

Nombre	Tipo	Description
properties.actions	Actions	Acciones que se invocarán cuando se active la alerta.
properties.autoMitigate	boolean	Marca que indica si la alerta se debe resolver automáticamente o no. El valor predeterminado es true. Solo es relevante para las reglas del tipo LogAlert.
properties.checkWorkspaceAlertsStorageConfigured	boolean	Marca que indica si esta regla de consulta programada debe almacenarse en el almacenamiento del cliente. El valor predeterminado es false. Solo es relevante para las reglas del tipo LogAlert.
properties.createdWithApiVersion	string	Versión de api usada al crear esta regla de alerta
properties.criteria	ScheduledQueryRuleCriteria	Criterios de regla que definen las condiciones de la regla de consulta programada.
properties.description	string	Descripción de la regla de consulta programada.
properties.displayName	string	Nombre para mostrar de la regla de alertas
properties.enabled	boolean	Marca que indica si esta regla de consulta programada está habilitada. El valor debe ser true o false
properties.evaluationFrequency	string	Frecuencia con la que se evalúa la regla de consulta programada representada en formato de duración ISO 8601. Relevante y solo es necesario para las reglas del tipo LogAlert.
properties.isLegacyLogAnalyticsRule	boolean	True si la regla de alertas es una regla heredada de Log Analytics
properties.isWorkspaceAlertsStorageConfigured	boolean	Marca que indica si esta regla de consulta programada se ha configurado para almacenarse en el almacenamiento del cliente. El valor predeterminado es false.
properties.muteActionsDuration	string	Silenciar acciones durante el período de tiempo elegido (en formato de duración ISO 8601) después de que se desencadene la alerta. Solo es relevante para las reglas del tipo LogAlert.
properties.overrideQueryTimeRange	string	Si se especifica, invalida el intervalo de tiempo de consulta (el valor predeterminado es WindowSize*NumberOfEvaluationPeriods). Solo es relevante para las reglas del tipo LogAlert.
properties.scopes	string[]	La lista de identificadores de recurso a la que se limita esta regla de consulta programada.
properties.severity	AlertSeverity	Gravedad de la alerta. Debe ser un entero entre [0-4]. El valor de 0 es más grave. Relevante y solo es necesario para las reglas del tipo LogAlert.
properties.skipQueryValidation	boolean	Marca que indica si se debe validar o no la consulta proporcionada. El valor predeterminado es false. Solo es relevante para las reglas del tipo LogAlert.
properties.targetResourceTypes	string[]	Lista del tipo de recurso de los recursos de destino en los que se crea o actualiza la alerta. Por ejemplo, si el ámbito es un grupo de recursos y targetResourceTypes es Microsoft.Compute/virtualMachines, se desencadenará una alerta diferente para cada máquina virtual del grupo de recursos que cumpla los criterios de alerta. Solo es relevante para las reglas del tipo LogAlert.
properties.windowSize	string	Período de tiempo (en formato de duración ISO 8601) en el que se ejecutará la consulta de alerta (tamaño de intervalo). Relevante y solo es necesario para las reglas del tipo LogAlert.
tags	object	Etiquetas del recurso

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Nombre	Tipo	Description
createdAt	string	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

timeAggregation

Tipo de agregación. Relevante y solo es necesario para las reglas del tipo LogAlert.

Nombre	Tipo	Description
Average	string
Count	string
Maximum	string
Minimum	string
Total	string

Compartir a través de