Partager via

az monitor alert-processing-rule

  • Préversion
  • Référence

Remarque

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 commande az monitor alert-processing-rule . En savoir plus sur les extensions.

Ce groupe de commandes est en préversion et en cours de développement. Référence et niveaux 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 Statut
az monitor alert-processing-rule create

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

 Extension Aperçu
az monitor alert-processing-rule delete

Supprimez une règle de traitement des alertes.

 Extension Aperçu
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 Aperçu
az monitor alert-processing-rule show

Obtenir une règle de traitement des alertes.

 Extension Aperçu
az monitor alert-processing-rule update

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

 Extension Aperçu

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. Référence et niveaux 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éez ou mettez à jour une règle qui supprime tous les groupes d’actions en dehors des heures d’ouverture (Le 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 en utilisant az configure --defaults group=<name>.

--rule-type

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

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

--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).

valeurs acceptées: false, true
--filter-alert-context

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

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

--filter-alert-rule-description

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

--filter-alert-rule-id

Filtrez les alertes par ID d’alerte.

--filter-alert-rule-name

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

--filter-monitor-condition

Filtrez les alertes par condition de surveillance.

--filter-monitor-service

Filtrez les alertes par service de surveillance.

--filter-resource-group

Filtrez les alertes par groupe de ressources.

--filter-resource-type

Filtrez les alertes par type de ressource.

--filter-severity

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

--filter-signal-type

Filtrez les alertes par type de signal.

--filter-target-resource

Filtrez les alertes par ressource.

--schedule-end-datetime

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

--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).

--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).

--schedule-recurrence-2-end-time

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

--schedule-recurrence-2-start-time

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

--schedule-recurrence-2-type

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

valeurs acceptées: Daily, Monthly, Weekly
--schedule-recurrence-end-time

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

--schedule-recurrence-start-time

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

--schedule-recurrence-type

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

valeurs acceptées: Daily, Monthly, Weekly
--schedule-start-datetime

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

--schedule-time-zone

Planifiez le fuseau horaire.

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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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. Référence et niveaux 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

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».

--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 en utilisant az configure --defaults group=<name>.

--subscription

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

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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. Référence et niveaux 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

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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. Référence et niveaux 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

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».

--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 en utilisant az configure --defaults group=<name>.

--subscription

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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. Référence et niveaux 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

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

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).

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.

valeur par défaut: False
--ids

Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».

--name -n

Nom de la règle de traitement des alertes.

--remove

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

valeur par défaut: []
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

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

valeur par défaut: []
--subscription

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

--tags

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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