Partilhar via

az monitor alert-processing-rule

  • Pré-visualizar

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 será instalada automaticamente na primeira vez que você executar um comando az monitor alert-processing-rule. Saiba mais sobre extensões.

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerencie a regra de processamento de alertas com o gerenciamento de alertas.

Comandos

Name Description Tipo Status
az monitor alert-processing-rule create

Crie uma regra de processamento de alertas.

 Extension Preview
az monitor alert-processing-rule delete

Excluir uma regra de processamento de alerta.

 Extension Preview
az monitor alert-processing-rule list

Liste todas as regras de processamento de alertas em uma assinatura ou grupo de recursos.

 Extension Preview
az monitor alert-processing-rule show

Obtenha uma regra de processamento de alertas.

 Extension Preview
az monitor alert-processing-rule update

Habilitar, desabilitar ou atualizar tags para uma regra de processamento de alerta.

 Extension Preview

az monitor alert-processing-rule create

Pré-visualizar

O grupo de comandos 'monitor alert-processing-rule' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Crie uma regra de processamento 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]

Exemplos

Criar ou atualizar uma regra que adiciona um grupo de ações a todos os alertas de 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ção 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ção 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ção de todos os alertas de 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 remova todos os grupos de ação de todos os alertas em qualquer VM em dois grupos de recursos durante uma janela de manutenção recorrente (2200-0400 a cada Sáb e Sol, Hora Padrão da Índia)

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 remova todos os grupos de ação fora do horário comercial (Mon-Fri 09:00-17:00, Hora 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 Obrigatórios

--name -n

Nome da regra de processamento de alertas.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--rule-type

Indique o tipo da regra de processamento de alertas.

Propriedade Valor
Valores aceites: AddActionGroups, RemoveAllActionGroups
--scopes

Lista de IDs de recursos (delimitados por espaço) para escopo. A regra será aplicada a alertas que dispararam sobre recursos dentro desse escopo.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--action-groups

Lista de ids de recursos (delimitados por espaço) de grupos de ação a serem adicionados. Um uso desse argumento requer que o tipo de regra seja AddActionGroups.

--description

Descrição da regra de processamento de alertas.

--enabled

Indique se a regra de processamento de alerta fornecida está habilitada ou desabilitada (o padrão está habilitado).

Propriedade Valor
Valores aceites: false, true
--filter-alert-context

Filtrar alertas por contexto de alerta (carga útil).

O formato de filtro é <operator> <space-delimited values> onde Operator: one of Equals, NotEquals, Contains, DoesNotContain Values: Lista de valores a serem correspondidos para uma determinada condição.

Propriedade Valor
Grupo de parâmetros: Filter Arguments
--filter-alert-rule-description

Filtrar alertas por descrição da regra de alerta.

Propriedade Valor
Grupo de parâmetros: Filter Arguments
--filter-alert-rule-id

Filtre alertas por ID de alerta.

Propriedade Valor
Grupo de parâmetros: Filter Arguments
--filter-alert-rule-name

Filtrar alertas por nome da regra de alerta.

Propriedade Valor
Grupo de parâmetros: Filter Arguments
--filter-monitor-condition

Filtre alertas por condição do monitor.

Propriedade Valor
Grupo de parâmetros: Filter Arguments
--filter-monitor-service

Filtre alertas por serviço de monitor.

Propriedade Valor
Grupo de parâmetros: Filter Arguments
--filter-resource-group

Filtrar alertas por grupo de recursos.

Propriedade Valor
Grupo de parâmetros: Filter Arguments
--filter-resource-type

Filtre alertas por tipo de recurso.

Propriedade Valor
Grupo de parâmetros: Filter Arguments
--filter-severity

Filtre alertas por gravidade Sev0, Sev1, Sev2, Sev3, Sev4.

Propriedade Valor
Grupo de parâmetros: Filter Arguments
--filter-signal-type

Filtre alertas por tipo de sinal.

Propriedade Valor
Grupo de parâmetros: Filter Arguments
--filter-target-resource

Filtre alertas por recurso.

Propriedade Valor
Grupo de parâmetros: Filter Arguments
--schedule-end-datetime

Data de fim da regra. Formato: «AAAA-MM-DD hh:mm:ss».

Propriedade Valor
Grupo de parâmetros: Schedule Arguments
--schedule-recurrence

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
--schedule-recurrence-2

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
--schedule-recurrence-2-end-time

Hora de término para cada recorrência. Formato: hh:mm:ss.

Propriedade Valor
Grupo de parâmetros: Schedule Second Recurrence Arguments
--schedule-recurrence-2-start-time

Hora de início para cada recorrência. Formato: hh:mm:ss.

Propriedade Valor
Grupo de parâmetros: Schedule Second Recurrence Arguments
--schedule-recurrence-2-type

Especifica quando a regra de processamento deve ser aplicada. Padrão para Sempre.

Propriedade Valor
Grupo de parâmetros: Schedule Second Recurrence Arguments
Valores aceites: Daily, Monthly, Weekly
--schedule-recurrence-end-time

Hora de término para cada recorrência. Formato: 'hh:mm:ss'.

Propriedade Valor
Grupo de parâmetros: Schedule First Recurrence Arguments
--schedule-recurrence-start-time

Hora de início para cada recorrência. Formato: 'hh:mm:ss'.

Propriedade Valor
Grupo de parâmetros: Schedule First Recurrence Arguments
--schedule-recurrence-type

Especifica quando a regra de processamento deve ser aplicada.

Propriedade Valor
Grupo de parâmetros: Schedule First Recurrence Arguments
Valores aceites: Daily, Monthly, Weekly
--schedule-start-datetime

Data de início da regra. Formato: «AAAA-MM-DD hh:mm:ss».

Propriedade Valor
Grupo de parâmetros: Schedule Arguments
--schedule-time-zone

Agendar fuso horário.

Propriedade Valor
Grupo de parâmetros: Schedule Arguments
Default value: UTC
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az monitor alert-processing-rule delete

Pré-visualizar

O grupo de comandos 'monitor alert-processing-rule' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Excluir uma regra de processamento de alerta.

az monitor alert-processing-rule delete [--ids]
                                        [--name]
                                        [--resource-group]
                                        [--subscription]
                                        [--yes]

Exemplos

Excluir 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 tornar-se necessários para que o comando seja executado com êxito.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

Nome da regra de processamento de alertas.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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
--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--yes -y

Não solicite confirmação.

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az monitor alert-processing-rule list

Pré-visualizar

O grupo de comandos 'monitor alert-processing-rule' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Liste todas as regras de processamento de alertas em uma assinatura ou grupo de recursos.

az monitor alert-processing-rule list [--resource-group]

Exemplos

Listar todas as regras de processamento de alertas na assinatura atual

az monitor alert-processing-rule list

Listar todas as regras de processamento de alertas 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 tornar-se necessários para que o comando seja executado com êxito.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az monitor alert-processing-rule show

Pré-visualizar

O grupo de comandos 'monitor alert-processing-rule' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Obtenha uma regra de processamento de alertas.

az monitor alert-processing-rule show [--ids]
                                      [--name]
                                      [--resource-group]
                                      [--subscription]

Exemplos

Obter uma regra de processamento de alertas por nome

az monitor alert-processing-rule show \
--name myRuleName \
--resource-group myRuleNameResourceGroup

Obter 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 tornar-se necessários para que o comando seja executado com êxito.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

Nome da regra de processamento de alertas.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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
--subscription

Nome ou ID da subscrição. 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 de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az monitor alert-processing-rule update

Pré-visualizar

O grupo de comandos 'monitor alert-processing-rule' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Habilitar, desabilitar ou atualizar tags 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 tornar-se necessários para que o comando seja executado com êxito.

--add

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
Default value: []
--enabled

Indique se a regra de processamento determinada está habilitada ou desabilitada (os valores são True e False).

Propriedade Valor
Valores aceites: false, true
--force-string

Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Default value: False
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

Nome da regra de processamento de alertas.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Default value: []
--resource-group -g

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
--set

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
Default value: []
--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False