az monitor action-rule

Nota

Esta referência faz parte da extensão de gestão de alertas para o Azure CLI e requer a versão 2.3.1 ou superior. A extensão instala-se automaticamente na primeira vez que executar um comando de regra de ação az monitor. Saiba mais sobre extensões.

Ordens para gerir a regra de ação.

Comandos

az monitor action-rule create

Criar uma regra de ação.

az monitor action-rule delete

Apagar uma regra de ação.

az monitor action-rule list

Listar todas as regras de ação da subscrição, criadas num determinado grupo de recursos e com filtros de entrada.

az monitor action-rule show

Arranja uma regra de ação.

az monitor action-rule update

Atualize uma regra de ação.

az monitor action-rule create

Criar uma regra de ação.

az monitor action-rule create --name
                              --resource-group
                              --rule-type {ActionGroup, Diagnostics, Suppression}
                              [--alert-context]
                              [--alert-description]
                              [--alert-rule]
                              [--description]
                              [--location]
                              [--monitor-condition]
                              [--monitor-service]
                              [--scope]
                              [--scope-type {Resource, ResourceGroup}]
                              [--severity]
                              [--status {Disabled, Enabled}]
                              [--suppression-end-date]
                              [--suppression-end-time]
                              [--suppression-recurrence]
                              [--suppression-recurrence-type {Always, Daily, Monthly, Once, Weekly}]
                              [--suppression-start-date]
                              [--suppression-start-time]
                              [--tags]
                              [--target-resource-type]

Exemplos

Crie uma regra de ação para suprimir notificações para todos os alertas Sev4 em todos os VMs dentro da subscrição todos os fins de semana

az monitor action-rule create --resource-group rg --name rule --location Global --status Enabled --rule-type Suppression --severity Equals Sev4 --target-resource-type Equals Microsoft.Compute/VirtualMachines --suppression-recurrence-type Weekly --suppression-recurrence 0 6 --suppression-start-date 12/09/2018 --suppression-end-date 12/18/2018 --suppression-start-time 06:00:00 --suppression-end-time 14:00:00

Crie uma regra de ação para suprimir notificações para todos os alertas de registo gerados para Computador-01 na subscrição indefinidamente, uma vez que está a passar pela manutenção

az monitor action-rule create --resource-group rg --name rule --location Global --status Enabled --rule-type Suppression --suppression-recurrence-type Always --alert-context Contains Computer-01 --monitor-service Equals "Log Analytics"

Criar uma regra de ação para suprimir notificações num grupo de recursos

az monitor action-rule create --resource-group rg --name rule --location Global --status Enabled --rule-type Suppression --scope-type ResourceGroup --scope /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg --suppression-recurrence-type Always --alert-context Contains Computer-01 --monitor-service Equals "Log Analytics"

Parâmetros Obrigatórios

--name -n

Nome da regra de ação.

--resource-group -g

o nome do grupo de recursos. Pode configurar o grupo predefinido utilizando az configure --defaults group=<name> .

--rule-type

Indicar tipo de regra de ação.

valores aceites: ActionGroup, Diagnostics, Suppression

Parâmetros Opcionais

--alert-context

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

--alert-description

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

--alert-rule

Filtrar alertas por nome ou ID da regra de alerta.

--description

Descrição da regra de ação.

--location -l

Localização. Valores de: az account list-locations . Pode configurar a localização padrão utilizando az configure --defaults location=<location> .

--monitor-condition

Filtrar alertas por condição do monitor.

--monitor-service

Filtrar alertas por serviço de monitor.

--scope

Lista de IDs ARM (delimitados pelo espaço) do tipo de âmbito dado que será o alvo da regra de ação dada.

--scope-type

Tipo de mira de alvo.

valores aceites: Resource, ResourceGroup
--severity

Filtrar alertas por gravidade. Todos os filtros devem seguir o formato "valor do operador 1 valor2 ... valueN". O operador é um dos Iguais, NotEquals, Contém e Não Existe.

--status

Indicar se a regra de ação dada está ativada ou desativada. Predefinido para ativar.

valores aceites: Disabled, Enabled
--suppression-end-date

Data final para a supressão. Formato: MM/DD/YYYY.

--suppression-end-time

Fim do tempo para a supressão. Formato: hh:mm:ss.

--suppression-recurrence

Lista de valores de padrão de recorrência, delimitada pelo espaço. Se --supressão-recorrência-tipo é semanal, os valores permitidos variam de 0 a 6. 0 para domingo, 1 para segunda-feira, ..., 6 para sábado. Se --supressão-recorrência-tipo é mensal, os valores permitidos variam de 1 a 31, significa para o dia do mês.

--suppression-recurrence-type

Especifica quando a supressão deve ser aplicada.

valores aceites: Always, Daily, Monthly, Once, Weekly
--suppression-start-date

Data de início para a supressão. Formato: MM/DD/YYYY.

--suppression-start-time

Hora de início para a supressão. Formato: hh:mm:ss.

--tags

Etiquetas separadas pelo espaço: chave[=valor] [chave[=valor] ...]. Utilize "" para limpar as etiquetas existentes.

--target-resource-type

Filtrar alertas por tipo de recurso alvo.

az monitor action-rule delete

Apagar uma regra de ação.

az monitor action-rule delete --name
                              --resource-group

Exemplos

Eliminar uma regra de ação

az monitor action-rule delete --resource-group rg --name rule

Parâmetros Obrigatórios

--name -n

Nome da regra de ação.

--resource-group -g

o nome do grupo de recursos. Pode configurar o grupo predefinido utilizando az configure --defaults group=<name> .

az monitor action-rule list

Listar todas as regras de ação da subscrição, criadas num determinado grupo de recursos e com filtros de entrada.

az monitor action-rule list [--action-group]
                            [--alert-rule-id]
                            [--description]
                            [--impacted-scope]
                            [--monitor-service]
                            [--name]
                            [--resource-group]
                            [--severity]
                            [--target-resource]
                            [--target-resource-group]
                            [--target-resource-type]

Exemplos

Listar regras de ação da subscrição

az monitor action-rule list

Listar regras de ação do grupo de recursos

az monitor action-rule list --resource-group rg

Parâmetros Opcionais

--action-group

Filtrar por grupo de ação configurado como parte da regra de ação.

--alert-rule-id

Filtrar por identificação da regra de alerta.

--description

Filtrar por descrição da regra de alerta.

--impacted-scope

Filtrar por âmbito impactado/alvo (fornecer lista separada de vírgula para vários âmbitos). O valor deve ser uma identificação braço bem construída do âmbito.

--monitor-service

Filtrar por serviço de monitor que gere a hora de alerta. O valor predefinido é selecionar tudo.

--name

Filtrar por nome da regra de ação.

--resource-group -g

o nome do grupo de recursos. Pode configurar o grupo predefinido utilizando az configure --defaults group=<name> .

--severity

Filtrar por gravidade. O valor predefinido é selecionar tudo.

--target-resource

Filtrar por recurso-alvo (que é iD braço completo). O valor predefinido é selecionar tudo.

--target-resource-group

Filtrar pelo nome do grupo de recursos-alvo. O valor predefinido é selecionar tudo.

--target-resource-type

Filtrar por tipo de recurso alvo. O valor predefinido é selecionar tudo.

az monitor action-rule show

Arranja uma regra de ação.

az monitor action-rule show --name
                            --resource-group

Exemplos

Obtenha uma regra de ação

az monitor action-rule show --resource-group rg --name rule

Parâmetros Obrigatórios

--name -n

Nome da regra de ação.

--resource-group -g

o nome do grupo de recursos. Pode configurar o grupo predefinido utilizando az configure --defaults group=<name> .

az monitor action-rule update

Atualize uma regra de ação.

az monitor action-rule update --name
                              --resource-group
                              [--add]
                              [--force-string]
                              [--location]
                              [--remove]
                              [--set]
                              [--status {Disabled, Enabled}]
                              [--tags]

Exemplos

Atualizar uma regra de ação

az monitor action-rule update --resource-group rg --name rule --status Disabled

Parâmetros Obrigatórios

--name -n

Nome da regra de ação.

--resource-group -g

o nome do grupo de recursos. Pode configurar o grupo predefinido utilizando az configure --defaults group=<name> .

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor chave. Exemplo: --adicionar propriedade.listProperty <chave=valor, string ou> de cadeia JSON.

--force-string

Ao utilizar 'set' ou 'add', preserve as cordas literais em vez de tentar converter-se em JSON.

--location -l

Localização. Valores de: az account list-locations . Pode configurar a localização padrão utilizando az configure --defaults location=<location> .

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remover propriedade.list OR --remover propriedadeToRemove.

--set

Atualize um objeto especificando um caminho de propriedade e valor a definir. Exemplo: --set property1.property2=.

--status

Indica se a regra de ação dada está ativada ou desativada.

valores aceites: Disabled, Enabled
--tags

Etiquetas separadas pelo espaço: chave[=valor] [chave[=valor] ...]. Utilize "" para limpar as etiquetas existentes.