az monitor alert-processing-rule
Note
Essa referência faz parte da extensão alertsmanagement para a CLI do Azure (versão 2.45.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az monitor alert-processing-rule. Saiba mais sobre extensões.
Esse grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Gerenciar a regra de processamento de alertas com alertsmanagement.
Comandos
| Nome | Description | Tipo | Status |
|---|---|---|---|
| az monitor alert-processing-rule create |
Crie uma regra de processamento de alerta. |
Extension | Preview |
| az monitor alert-processing-rule delete |
Exclua uma regra de processamento de alerta. |
Extension | Preview |
| az monitor alert-processing-rule list |
Lista todas as regras de processamento de alerta em uma assinatura ou grupo de recursos. |
Extension | Preview |
| az monitor alert-processing-rule show |
Obtenha uma regra de processamento de alerta. |
Extension | Preview |
| az monitor alert-processing-rule update |
Habilitar, desabilitar ou atualizar marcas para uma regra de processamento de alerta. |
Extension | Preview |
az monitor alert-processing-rule create
O grupo de comandos 'monitor alert-processing-rule' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Crie uma regra de processamento de alerta.
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]
Exemplos
Criar ou atualizar uma regra que adiciona um grupo de ações a todos os alertas em uma assinatura
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"
Criar ou atualizar uma regra que adiciona dois grupos de ações a todos os alertas Sev0 e Sev1 em dois 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"
Criar ou atualizar uma regra que remove todos os grupos de ações de alertas em uma VM específica durante uma janela de manutenção única (1800-2000 em uma data específica, Hora Padrão do 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"
Criar ou atualizar uma regra que remove todos os grupos de ações de todos os alertas em uma assinatura proveniente de uma regra 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"
Criar ou atualizar uma regra que remove todos os grupos de ações de todos os alertas em qualquer VM em dois grupos de recursos durante uma janela de manutenção recorrente (2200-0400 a cada Sat e Sun, India Standard Time)
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"
Criar ou atualizar uma regra que remove todos os grupos de ações fora do horário comercial (Mon-Fri 09:00-17:00, Horário Padrão do Leste)
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 Exigidos
Nome da regra de processamento de alerta.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Indique o tipo da regra de processamento de alerta.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | AddActionGroups, RemoveAllActionGroups |
Lista de IDs de recurso (delimitadas por espaço) para escopo. A regra será aplicada a alertas disparados em recursos dentro desse escopo.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Lista de IDs de recurso (delimitadas por espaço) de grupos de ações a serem adicionados. Um uso desse argumento requer que o tipo de regra seja AddActionGroups.
Descrição da regra de processamento de alerta.
Indique se a regra de processamento de alerta fornecida está habilitada ou desabilitada (o padrão está habilitado).
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
Filtrar alertas por contexto de alerta (conteúdo).
O formato de filtro é <operator> <space-delimited values> onde Operador: um dos valores Equals, NotEquals, Contains, DoesNotContain: Lista de valores a serem correspondentes a uma determinada condição.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Filter Arguments |
Filtrar alertas por descrição da regra de alerta.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Filter Arguments |
Filtrar alertas por ID de alerta.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Filter Arguments |
Filtrar alertas pelo nome da regra de alerta.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Filter Arguments |
Filtrar alertas por condição de monitor.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Filter Arguments |
Filtrar alertas pelo serviço de monitor.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Filter Arguments |
Filtrar alertas por grupo de recursos.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Filter Arguments |
Filtrar alertas por tipo de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Filter Arguments |
Filtrar alertas por severidade Sev0, Sev1, Sev2, Sev3, Sev4.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Filter Arguments |
Filtrar alertas por tipo de sinal.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Filter Arguments |
Filtrar alertas por recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Filter Arguments |
Data de término da regra. Formato: 'YYYY-MM-DD hh:mm:ss'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Schedule Arguments |
Lista de valores de padrão de recorrência.
--schedule-recurrence: lista de valores de padrão de recorrência (delimitado por espaço). Para um tipo de recorrência semanal, os valores permitidos são de domingo a sábado. Para um tipo de recorrência mensal, os valores permitidos são de 1 a 31 (dias do mês).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Schedule First Recurrence Arguments |
Lista de valores de padrão de recorrência para o segundo padrão de recorrência.
--schedule-recurrence-2: lista de valores de padrão de recorrência (delimitado por espaço). Para um tipo de recorrência semanal, os valores permitidos são de domingo a sábado. Para um tipo de recorrência mensal, os valores permitidos são de 1 a 31 (dias do mês).
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Schedule Second Recurrence Arguments |
Hora de término para cada recorrência. Formato: hh:mm:ss.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Schedule Second Recurrence Arguments |
Hora de início para cada recorrência. Formato: hh:mm:ss.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Schedule Second Recurrence Arguments |
Especifica quando a regra de processamento deve ser aplicada. Padrão para Always.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Schedule Second Recurrence Arguments |
| Valores aceitos: | Daily, Monthly, Weekly |
Hora de término para cada recorrência. Formato: 'hh:mm:ss'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Schedule First Recurrence Arguments |
Hora de início para cada recorrência. Formato: 'hh:mm:ss'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Schedule First Recurrence Arguments |
Especifica quando a regra de processamento deve ser aplicada.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Schedule First Recurrence Arguments |
| Valores aceitos: | Daily, Monthly, Weekly |
Data de início da regra. Formato: 'YYYY-MM-DD hh:mm:ss'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Schedule Arguments |
Agendar fuso horário.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Schedule Arguments |
| Valor padrão: | UTC |
Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az monitor alert-processing-rule delete
O grupo de comandos 'monitor alert-processing-rule' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Exclua uma regra de processamento de alerta.
az monitor alert-processing-rule delete [--ids]
[--name]
[--resource-group]
[--subscription]
[--yes]
Exemplos
Exclua uma regra de processamento de alerta.
az monitor alert-processing-rule delete \
--resource-group myResourceGroup \
--name myRuleName
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome da regra de processamento de alerta.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Não solicite confirmação.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az monitor alert-processing-rule list
O grupo de comandos 'monitor alert-processing-rule' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Lista todas as regras de processamento de alerta em uma assinatura ou grupo de recursos.
az monitor alert-processing-rule list [--resource-group]
Exemplos
Listar todas as regras de processamento de alerta na assinatura atual
az monitor alert-processing-rule list
Listar todas as regras de processamento de alerta em um grupo de recursos
az monitor alert-processing-rule list \
--resource-group myResourceGroup
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az monitor alert-processing-rule show
O grupo de comandos 'monitor alert-processing-rule' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Obtenha uma regra de processamento de alerta.
az monitor alert-processing-rule show [--ids]
[--name]
[--resource-group]
[--subscription]
Exemplos
Obter uma regra de processamento de alerta por nome
az monitor alert-processing-rule show \
--name myRuleName \
--resource-group myRuleNameResourceGroup
Obter a regra de processamento de alertas por IDs
az monitor alert-processing-rule show \
--ids ruleId1 ruleId2
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome da regra de processamento de alerta.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az monitor alert-processing-rule update
O grupo de comandos 'monitor alert-processing-rule' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Habilitar, desabilitar ou atualizar marcas para uma regra de processamento de alerta.
az monitor alert-processing-rule update [--add]
[--enabled {false, true}]
[--force-string]
[--ids]
[--name]
[--remove]
[--resource-group]
[--set]
[--subscription]
[--tags]
Exemplos
PatchAlertProcessingRule
az monitor alert-processing-rule update \
--name "WeeklySuppression" \
--enabled false \
--tags key1="value1" key2="value2" --resource-group "alertscorrelationrg"
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Valor padrão: | [] |
Indique se a regra de processamento fornecida está habilitada ou desabilitada (os valores são True e False).
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Valor padrão: | False |
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome da regra de processamento de alerta.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Valor padrão: | [] |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Valor padrão: | [] |
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |