az monitor alert-processing-rule
Note
Esta referencia forma parte de la extensión alertsmanagement para la CLI de Azure (versión 2.45.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az monitor alert-processing-rule. Obtenga más información sobre las extensiones.
Este grupo de comandos está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Administrar la regla de procesamiento de alertas con alertsmanagement.
Comandos
| Nombre | Description | Tipo | Estado |
|---|---|---|---|
| az monitor alert-processing-rule create |
Creación de una regla de procesamiento de alertas. |
Extension | Preview |
| az monitor alert-processing-rule delete |
Elimine una regla de procesamiento de alertas. |
Extension | Preview |
| az monitor alert-processing-rule list |
Enumere todas las reglas de procesamiento de alertas en una suscripción o grupo de recursos. |
Extension | Preview |
| az monitor alert-processing-rule show |
Obtener una regla de procesamiento de alertas. |
Extension | Preview |
| az monitor alert-processing-rule update |
Habilite, deshabilite o actualice etiquetas para una regla de procesamiento de alertas. |
Extension | Preview |
az monitor alert-processing-rule create
El grupo de comandos "monitor alert-processing-rule" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Creación de una regla de procesamiento de alertas.
az monitor alert-processing-rule create --name
--resource-group
--rule-type {AddActionGroups, RemoveAllActionGroups}
--scopes
[--action-groups]
[--description]
[--enabled {false, true}]
[--filter-alert-context]
[--filter-alert-rule-description]
[--filter-alert-rule-id]
[--filter-alert-rule-name]
[--filter-monitor-condition]
[--filter-monitor-service]
[--filter-resource-group]
[--filter-resource-type]
[--filter-severity]
[--filter-signal-type]
[--filter-target-resource]
[--schedule-end-datetime]
[--schedule-recurrence]
[--schedule-recurrence-2]
[--schedule-recurrence-2-end-time]
[--schedule-recurrence-2-start-time]
[--schedule-recurrence-2-type {Daily, Monthly, Weekly}]
[--schedule-recurrence-end-time]
[--schedule-recurrence-start-time]
[--schedule-recurrence-type {Daily, Monthly, Weekly}]
[--schedule-start-datetime]
[--schedule-time-zone]
[--tags]
Ejemplos
Crear o actualizar una regla que agrega un grupo de acciones a todas las alertas de una suscripción
az monitor alert-processing-rule create \
--name 'AddActionGroupToSubscription' \
--rule-type AddActionGroups \
--scopes "/subscriptions/MySubscriptionId" \
--action-groups "/subscriptions/MySubscriptionId/resourcegroups/MyResourceGroup1/providers/microsoft.insights/actiongroups/ActionGroup1" \
--enabled true \
--resource-group alertscorrelationrg \
--description "Add ActionGroup1 to all alerts in the subscription"
Cree o actualice una regla que agregue dos grupos de acciones a todas las alertas de Sev0 y Sev1 en dos grupos de recursos.
az monitor alert-processing-rule create \
--name 'AddActionGroupsBySeverity' \
--rule-type AddActionGroups \
--action-groups "/subscriptions/MySubscriptionId/resourcegroups/MyResourceGroup1/providers/microsoft.insights/actiongroups/MyActionGroupId1" "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup2/providers/microsoft.insights/actionGroups/MyActionGroup2" \
--scopes "/subscriptions/MySubscriptionId" \
--resource-group alertscorrelationrg \
--filter-severity Equals Sev0 Sev1 \
--description "Add AGId1 and AGId2 to all Sev0 and Sev1 alerts in these resourceGroups"
Cree o actualice una regla que quite todos los grupos de acciones de las alertas de una máquina virtual específica durante una ventana de mantenimiento puntual (1800-2000 en una fecha específica, Hora estándar del Pacífico).
az monitor alert-processing-rule create \
--name 'RemoveActionGroupsMaintenanceWindow' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup1/providers/Microsoft.Compute/virtualMachines/VMName" \
--resource-group alertscorrelationrg \
--schedule-start-datetime '2022-01-02 18:00:00' \
--schedule-end-datetime '2022-01-02 20:00:00' \
--schedule-time-zone 'Pacific Standard Time' \
--description "Removes all ActionGroups from all Alerts on VMName during the maintenance window"
Cree o actualice una regla que quite todos los grupos de acciones de todas las alertas de una suscripción procedentes de una regla de alerta específica.
az monitor alert-processing-rule create \
--name 'RemoveActionGroupsSpecificAlertRule' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId" \
--resource-group alertscorrelationrg \
--filter-alert-rule-id Equals "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup1/providers/microsoft.insights/activityLogAlerts/RuleName" \
--description "Removes all ActionGroups from all Alerts that fire on above AlertRule"
Cree o actualice una regla que quite todos los grupos de acciones de todas las alertas de cualquier máquina virtual de dos grupos de recursos durante una ventana de mantenimiento periódica (2200-0400 cada sat y sol, hora estándar de la India)
az monitor alert-processing-rule create \
--name 'RemoveActionGroupsRecurringMaintenance' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup1" "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup2" \
--resource-group alertscorrelationrg \
--filter-resource-type Equals "microsoft.compute/virtualmachines" \
--schedule-time-zone "India Standard Time" \
--schedule-recurrence-type Weekly \
--schedule-recurrence-start-time "22:00:00" \
--schedule-recurrence-end-time "04:00:00" \
--schedule-recurrence Sunday Saturday \
--description "Remove all ActionGroups from all Virtual machine Alerts during the recurring maintenance"
Cree o actualice una regla que quite todos los grupos de acciones fuera del horario comercial (Mon-Fri 09:00-17:00, Hora estándar del Este)
az monitor alert-processing-rule create \
--name 'RemoveActionGroupsOutsideBusinessHours' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId" \
--resource-group alertscorrelationrg \
--schedule-time-zone "Eastern Standard Time" \
--schedule-recurrence-type Daily \
--schedule-recurrence-start-time "17:00:00" \
--schedule-recurrence-end-time "09:00:00" \
--schedule-recurrence-2-type Weekly \
--schedule-recurrence-2 Saturday Sunday \
--description "Remove all ActionGroups outside business hours"
Parámetros requeridos
Nombre de la regla de procesamiento de alertas.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Indique el tipo de la regla de procesamiento de alertas.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | AddActionGroups, RemoveAllActionGroups |
Lista de identificadores de recursos (delimitados por espacio) para el ámbito. La regla se aplicará a las alertas que se desencadenaron en los recursos dentro de ese ámbito.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Lista de identificadores de recursos (delimitados por espacio) de grupos de acciones que se van a agregar. Un uso de este argumento requiere que el tipo de regla sea AddActionGroups.
Descripción de la regla de procesamiento de alertas.
Indique si la regla de procesamiento de alertas especificada está habilitada o deshabilitada (el valor predeterminado está habilitado).
| Propiedad | Valor |
|---|---|
| Valores aceptados: | false, true |
Filtre las alertas por contexto de alerta (carga).
El formato de filtro es <operator> <space-delimited values> donde Operator: uno de Equals, NotEquals, Contains, DoesNotContain Values: Lista de valores que deben coincidir con una condición determinada.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Filter Arguments |
Filtre las alertas por descripción de la regla de alertas.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Filter Arguments |
Filtre las alertas por identificador de alerta.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Filter Arguments |
Filtre las alertas por nombre de regla de alerta.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Filter Arguments |
Filtre las alertas por condición de supervisión.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Filter Arguments |
Filtre las alertas por servicio de supervisión.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Filter Arguments |
Filtre las alertas por grupo de recursos.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Filter Arguments |
Filtre las alertas por tipo de recurso.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Filter Arguments |
Filtre las alertas por gravedad Sev0, Sev1, Sev2, Sev3, Sev4.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Filter Arguments |
Filtre las alertas por tipo de señal.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Filter Arguments |
Filtre las alertas por recurso.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Filter Arguments |
Fecha de finalización de la regla. Formato: "AAAA-MM-DD hh:mm:ss".
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schedule Arguments |
Lista de valores de patrón de periodicidad.
--schedule-recurrence: lista de valores de patrón de periodicidad (delimitados por espacio). Para un tipo de periodicidad semanal, los valores permitidos son domingo a sábado. Para un tipo de periodicidad mensual, los valores permitidos son de 1 a 31 (días de mes).
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schedule First Recurrence Arguments |
Lista de valores de patrón de periodicidad para el segundo patrón de periodicidad.
--schedule-recurrence-2: lista de valores de patrón de periodicidad (delimitados por espacio). Para un tipo de periodicidad semanal, los valores permitidos son domingo a sábado. Para un tipo de periodicidad mensual, los valores permitidos son de 1 a 31 (días de mes).
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schedule Second Recurrence Arguments |
Hora de finalización de cada periodicidad. Formato: hh:mm:ss.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schedule Second Recurrence Arguments |
Hora de inicio de cada periodicidad. Formato: hh:mm:ss.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schedule Second Recurrence Arguments |
Especifica cuándo se debe aplicar la regla de procesamiento. Valor predeterminado es Always.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schedule Second Recurrence Arguments |
| Valores aceptados: | Daily, Monthly, Weekly |
Hora de finalización de cada periodicidad. Formato: 'hh:mm:ss'.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schedule First Recurrence Arguments |
Hora de inicio de cada periodicidad. Formato: 'hh:mm:ss'.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schedule First Recurrence Arguments |
Especifica cuándo se debe aplicar la regla de procesamiento.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schedule First Recurrence Arguments |
| Valores aceptados: | Daily, Monthly, Weekly |
Fecha de inicio de la regla. Formato: "AAAA-MM-DD hh:mm:ss".
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schedule Arguments |
Programar zona horaria.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Schedule Arguments |
| Valor predeterminado: | UTC |
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az monitor alert-processing-rule delete
El grupo de comandos "monitor alert-processing-rule" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Elimine una regla de procesamiento de alertas.
az monitor alert-processing-rule delete [--ids]
[--name]
[--resource-group]
[--subscription]
[--yes]
Ejemplos
Elimine una regla de procesamiento de alertas.
az monitor alert-processing-rule delete \
--resource-group myResourceGroup \
--name myRuleName
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Nombre de la regla de procesamiento de alertas.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
No solicita confirmación.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az monitor alert-processing-rule list
El grupo de comandos "monitor alert-processing-rule" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Enumere todas las reglas de procesamiento de alertas en una suscripción o grupo de recursos.
az monitor alert-processing-rule list [--resource-group]
Ejemplos
Enumerar todas las reglas de procesamiento de alertas de la suscripción actual
az monitor alert-processing-rule list
Enumeración de todas las reglas de procesamiento de alertas en un grupo de recursos
az monitor alert-processing-rule list \
--resource-group myResourceGroup
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az monitor alert-processing-rule show
El grupo de comandos "monitor alert-processing-rule" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Obtener una regla de procesamiento de alertas.
az monitor alert-processing-rule show [--ids]
[--name]
[--resource-group]
[--subscription]
Ejemplos
Obtención de una regla de procesamiento de alertas por nombre
az monitor alert-processing-rule show \
--name myRuleName \
--resource-group myRuleNameResourceGroup
Obtención de la regla de procesamiento de alertas por identificadores
az monitor alert-processing-rule show \
--ids ruleId1 ruleId2
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Nombre de la regla de procesamiento de alertas.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az monitor alert-processing-rule update
El grupo de comandos "monitor alert-processing-rule" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Habilite, deshabilite o actualice etiquetas para una regla de procesamiento de alertas.
az monitor alert-processing-rule update [--add]
[--enabled {false, true}]
[--force-string]
[--ids]
[--name]
[--remove]
[--resource-group]
[--set]
[--subscription]
[--tags]
Ejemplos
PatchAlertProcessingRule
az monitor alert-processing-rule update \
--name "WeeklySuppression" \
--enabled false \
--tags key1="value1" key2="value2" --resource-group "alertscorrelationrg"
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Generic Update Arguments |
| Valor predeterminado: | [] |
Indique si la regla de procesamiento especificada está habilitada o deshabilitada (los valores son True y False).
| Propiedad | Valor |
|---|---|
| Valores aceptados: | false, true |
Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Generic Update Arguments |
| Valor predeterminado: | False |
Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Nombre de la regla de procesamiento de alertas.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Generic Update Arguments |
| Valor predeterminado: | [] |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Generic Update Arguments |
| Valor predeterminado: | [] |
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |