Partager via


az monitor alert-processing-rule

Note

Cette référence fait partie de l’extension alertsmanagement pour Azure CLI (version 2.45.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une az monitor alert-processing-rule commande. Apprenez-en davantage sur les extensions.

Ce groupe de commandes est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Gérer la règle de traitement des alertes avec la gestion des alertes.

Commandes

Nom Description Type État
az monitor alert-processing-rule create

Créez une règle de traitement des alertes.

Extension Preview
az monitor alert-processing-rule delete

Supprimez une règle de traitement des alertes.

Extension Preview
az monitor alert-processing-rule list

Répertoriez toutes les règles de traitement des alertes dans un abonnement ou un groupe de ressources.

Extension Preview
az monitor alert-processing-rule show

Obtenir une règle de traitement des alertes.

Extension Preview
az monitor alert-processing-rule update

Activez, désactivez ou mettez à jour des balises pour une règle de traitement des alertes.

Extension Preview

az monitor alert-processing-rule create

Préversion

Le groupe de commandes « surveiller la règle de traitement des alertes » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Créez une règle de traitement des alertes.

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]

Exemples

Créer ou mettre à jour une règle qui ajoute un groupe d’actions à toutes les alertes d’un abonnement

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"

Créer ou mettre à jour une règle qui ajoute deux groupes d’actions à toutes les alertes Sev0 et Sev1 dans deux groupes de ressources

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"

Créez ou mettez à jour une règle qui supprime tous les groupes d’actions des alertes sur une machine virtuelle spécifique pendant une fenêtre de maintenance ponctuelle (1800-2000 à une date spécifique, Heure standard pacifique)

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"

Créer ou mettre à jour une règle qui supprime tous les groupes d’actions de toutes les alertes d’un abonnement provenant d’une règle d’alerte spécifique

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"

Créez ou mettez à jour une règle qui supprime tous les groupes d’actions de toutes les alertes sur n’importe quelle machine virtuelle dans deux groupes de ressources pendant une fenêtre de maintenance périodique (2200-0400 chaque sat et sun, Inde 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"

Créer ou mettre à jour une règle qui supprime tous les groupes d’actions en dehors des heures d’activité (Mon-Fri 09:00-17:00, Heure standard est)

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"

Paramètres obligatoires

--name -n

Nom de la règle de traitement des alertes.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--rule-type

Indiquez le type de la règle de traitement des alertes.

Propriété Valeur
Valeurs acceptées: AddActionGroups, RemoveAllActionGroups
--scopes

Liste des ID de ressource (délimités par l’espace) pour l’étendue. La règle s’applique aux alertes déclenchées sur les ressources dans cette étendue.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--action-groups

Liste des ID de ressource (délimités par l’espace) des groupes d’actions à ajouter. Une utilisation de cet argument nécessite que le type de règle soit AddActionGroups.

--description

Description de la règle de traitement des alertes.

--enabled

Indiquez si la règle de traitement des alertes donnée est activée ou désactivée (la valeur par défaut est activée).

Propriété Valeur
Valeurs acceptées: false, true
--filter-alert-context

Filtrez les alertes par contexte d’alerte (charge utile).

Le format de filtre est <operator> <space-delimited values> l’opérateur : un des valeurs Equals, NotEquals, Contains, DoesNotContain Values : List of values to match for a given condition.

Propriété Valeur
Groupe de paramètres: Filter Arguments
--filter-alert-rule-description

Filtrer les alertes par description de règle d’alerte.

Propriété Valeur
Groupe de paramètres: Filter Arguments
--filter-alert-rule-id

Filtrez les alertes par ID d’alerte.

Propriété Valeur
Groupe de paramètres: Filter Arguments
--filter-alert-rule-name

Filtrez les alertes par nom de règle d’alerte.

Propriété Valeur
Groupe de paramètres: Filter Arguments
--filter-monitor-condition

Filtrez les alertes par condition de surveillance.

Propriété Valeur
Groupe de paramètres: Filter Arguments
--filter-monitor-service

Filtrez les alertes par service de surveillance.

Propriété Valeur
Groupe de paramètres: Filter Arguments
--filter-resource-group

Filtrez les alertes par groupe de ressources.

Propriété Valeur
Groupe de paramètres: Filter Arguments
--filter-resource-type

Filtrez les alertes par type de ressource.

Propriété Valeur
Groupe de paramètres: Filter Arguments
--filter-severity

Filtrez les alertes par gravité Sev0, Sev1, Sev2, Sev3, Sev4.

Propriété Valeur
Groupe de paramètres: Filter Arguments
--filter-signal-type

Filtrez les alertes par type de signal.

Propriété Valeur
Groupe de paramètres: Filter Arguments
--filter-target-resource

Filtrez les alertes par ressource.

Propriété Valeur
Groupe de paramètres: Filter Arguments
--schedule-end-datetime

Date de fin de la règle. Format : 'AAAA-MM-DD hh :mm :ss'.

Propriété Valeur
Groupe de paramètres: Schedule Arguments
--schedule-recurrence

Liste des valeurs de modèle de périodicité.

--schedule-recurrence : liste des valeurs de modèle de périodicité (délimitées par l’espace). Pour un type de périodicité hebdomadaire, les valeurs autorisées sont dimanche à samedi. Pour un type de périodicité mensuelle, les valeurs autorisées sont comprises entre 1 et 31 (jours du mois).

Propriété Valeur
Groupe de paramètres: Schedule First Recurrence Arguments
--schedule-recurrence-2

Liste des valeurs de modèle de périodicité pour le deuxième modèle de périodicité.

--schedule-recurrence-2 : liste des valeurs de modèle de périodicité (délimitées par l’espace). Pour un type de périodicité hebdomadaire, les valeurs autorisées sont dimanche à samedi. Pour un type de périodicité mensuelle, les valeurs autorisées sont comprises entre 1 et 31 (jours du mois).

Propriété Valeur
Groupe de paramètres: Schedule Second Recurrence Arguments
--schedule-recurrence-2-end-time

Heure de fin de chaque périodicité. Format : hh :mm :ss.

Propriété Valeur
Groupe de paramètres: Schedule Second Recurrence Arguments
--schedule-recurrence-2-start-time

Heure de début de chaque périodicité. Format : hh :mm :ss.

Propriété Valeur
Groupe de paramètres: Schedule Second Recurrence Arguments
--schedule-recurrence-2-type

Spécifie quand la règle de traitement doit être appliquée. Valeur par défaut : Always.

Propriété Valeur
Groupe de paramètres: Schedule Second Recurrence Arguments
Valeurs acceptées: Daily, Monthly, Weekly
--schedule-recurrence-end-time

Heure de fin de chaque périodicité. Format : 'hh :mm :ss'.

Propriété Valeur
Groupe de paramètres: Schedule First Recurrence Arguments
--schedule-recurrence-start-time

Heure de début de chaque périodicité. Format : 'hh :mm :ss'.

Propriété Valeur
Groupe de paramètres: Schedule First Recurrence Arguments
--schedule-recurrence-type

Spécifie quand la règle de traitement doit être appliquée.

Propriété Valeur
Groupe de paramètres: Schedule First Recurrence Arguments
Valeurs acceptées: Daily, Monthly, Weekly
--schedule-start-datetime

Date de début de la règle. Format : 'AAAA-MM-DD hh :mm :ss'.

Propriété Valeur
Groupe de paramètres: Schedule Arguments
--schedule-time-zone

Planifiez le fuseau horaire.

Propriété Valeur
Groupe de paramètres: Schedule Arguments
Valeur par défaut: UTC
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az monitor alert-processing-rule delete

Préversion

Le groupe de commandes « surveiller la règle de traitement des alertes » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Supprimez une règle de traitement des alertes.

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

Exemples

Supprimez une règle de traitement des alertes.

az monitor alert-processing-rule delete \
--resource-group myResourceGroup \
--name myRuleName

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name -n

Nom de la règle de traitement des alertes.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--yes -y

N’invitez pas à confirmer.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az monitor alert-processing-rule list

Préversion

Le groupe de commandes « surveiller la règle de traitement des alertes » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Répertoriez toutes les règles de traitement des alertes dans un abonnement ou un groupe de ressources.

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

Exemples

Répertorier toutes les règles de traitement des alertes dans l’abonnement actuel

az monitor alert-processing-rule list

Répertorier toutes les règles de traitement des alertes dans un groupe de ressources

az monitor alert-processing-rule list \
--resource-group myResourceGroup

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az monitor alert-processing-rule show

Préversion

Le groupe de commandes « surveiller la règle de traitement des alertes » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Obtenir une règle de traitement des alertes.

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

Exemples

Obtenir une règle de traitement des alertes par nom

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

Obtenir une règle de traitement des alertes par ID

az monitor alert-processing-rule show \
--ids ruleId1 ruleId2

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name -n

Nom de la règle de traitement des alertes.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az monitor alert-processing-rule update

Préversion

Le groupe de commandes « surveiller la règle de traitement des alertes » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Activez, désactivez ou mettez à jour des balises pour une règle de traitement des alertes.

az monitor alert-processing-rule update [--add]
                                        [--enabled {false, true}]
                                        [--force-string]
                                        [--ids]
                                        [--name]
                                        [--remove]
                                        [--resource-group]
                                        [--set]
                                        [--subscription]
                                        [--tags]

Exemples

PatchAlertProcessingRule

az monitor alert-processing-rule update \
--name "WeeklySuppression" \
--enabled false \
--tags key1="value1" key2="value2" --resource-group "alertscorrelationrg"

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeur par défaut: []
--enabled

Indiquez si la règle de traitement donnée est activée ou désactivée (les valeurs sont True et False).

Propriété Valeur
Valeurs acceptées: false, true
--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeur par défaut: False
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name -n

Nom de la règle de traitement des alertes.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeur par défaut: []
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeur par défaut: []
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False