Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # mon-describe-alarms ## Description Permet d'obtenir des informations sur les alarmes spécifiées. Si vous ne spécifiez pas de nom d'alarme, cette commande renvoie des informations sur toutes vos alarmes. Vous pouvez récupérer des alarmes en utilisant uniquement le préfixe du nom d'alarme, l'état de l'alarme ou un préfixe d'action. ## Syntaxe ****mon-describe-alarms** [AlarmNames [*AlarmNames* ...]] [--action-prefix *value*] [--alarm-name-prefix *value*] [--state-value *value*] [Common Options]** ## Options | Nom | Description | | --- | --- | | `AlarmNames` `AlarmNames` | Noms des alarmes. Vous pouvez également définir cette valeur à l'aide de `--alarm-name`. Vous pouvez spécifier cette option plusieurs fois. Type : argument Valeurs valides : un nom d'alarme existant, sinon aucune réponse n'est renvoyée. Par défaut : S.o., affiche toutes les alarmes par défaut. Obligatoire : non | | `--action-prefix` `VALUE` | Préfixe des noms d'action. Type : argument Valeurs valides : le préfixe d'un nom d'action existant, au format ARN. Par défaut : S.o., affiche la première action par défaut. Obligatoire : non | | `--alarm-name-prefix` `VALUE` | Préfixe des noms d'alarme. Type : argument Valeurs valides : le préfixe d'un nom d'alarme existant. Par défaut : S.o. Obligatoire : non | | `--state-value` `VALUE` | État de l'alarme. Type : énumération Valeurs valides : OK, ALARM ou INSUFFICIENT\$1DATA Par défaut : tous les états d'alarme. Obligatoire : non | ## Options courantes | Nom | Description | | --- | --- | | `--aws-credential-file` `VALUE` | L'emplacement du fichier contenant vos AWS informations d'identification. Vous pouvez définir cette valeur à l'aide de la variable d'environnement `AWS_CREDENTIAL_FILE`. Si vous définissez la variable d'environnement ou si vous fournissez le chemin d'accès au fichier d'informations d'identification, le fichier doit exister ou la demande échoue. Toutes les CloudWatch demandes doivent être signées à l'aide de votre identifiant de clé d'accès et de votre clé d'accès secrète. Type : String Valeurs valides : chemin d'accès valide à un fichier contenant votre identifiant de clé d'accès et votre clé d'accès secrète. Par défaut : utilise la variable d'environnement `AWS_CREDENTIAL_FILE`, si elle est définie. | | `-C, --ec2-cert-file-path` `VALUE` | Emplacement de votre fichier de EC2 certificat pour les demandes de signature. Vous pouvez utiliser la variable d'environnement `EC2_CERT` pour spécifier cette valeur. Type : String Valeurs valides : chemin de fichier valide vers le fichier PEM fourni par Amazon EC2 ou Gestion des identités et des accès AWS. Par défaut : utilise la variable d'environnement `EC2_CERT`, si elle est définie. | | `--connection-timeout` `VALUE` | Valeur d'expiration de la connexion, en secondes. Type : Integer Valeurs valides : tout nombre positif. Valeur par défaut : 30 | | `--delimiter` `VALUE` | Le délimiteur à utiliser lors de l'affichage des résultats délimités (longs). Type : String Valeurs valides : toute chaîne. Par défaut : virgule (,) | | `--headers` `` | Si vous affichez des résultats tabulaires ou délimités, incluez les en-têtes de colonne. Si vous affichez des résultats XML, renvoyez les en-têtes HTTP de la demande de service, le cas échéant. Type : indicateur Valeurs valides : lorsqu'elles sont présentes, affiche les en-têtes. Par défaut : l'option `--headers` est désactivée par défaut. | | `-I, --access-key-id` `VALUE` | L'identifiant de clé d'accès utilisé conjointement à la clé secrète pour signer la demande. Cela doit être utilisé conjointement à --secret-key, sinon l'option est ignorée. Toutes les demandes CloudWatch doivent être signées, sinon elles sont rejetées. Type : String Valeurs valides : un identifiant de clé d'accès valide. Par défaut : aucun | | `-K, --ec2-private-key-file-path` `VALUE` | La clé privée utilisée pour signer la demande. L'utilisation de public/private clés entraîne l'utilisation de SOAP par la CLI. La demande est signée à l'aide d'un certificat public et d'une clé privée. Ce paramètre doit être utilisé en conjonction avec `EC2_CERT`, sinon la valeur est ignorée. La valeur de la variable d'environnement `EC2_PRIVATE_KEY` sera utilisée si elle est définie, et cette option n'est pas spécifiée. Cette option est ignorée si la variable d'environnement `AWS_CREDENTIAL_FILE` est définie, ou si `--aws-credentials-file` est utilisé. Toutes les demandes CloudWatch doivent être signées, sinon elles sont rejetées. Type : String Valeurs valides : chemin d'accès à une clé privée ASN.1 valide. Par défaut : aucun | | `--region` `VALUE` | Les demandes de région sont dirigées vers. Vous pouvez utiliser la variable d'environnement `EC2_REGION` pour spécifier la valeur. La région est utilisée pour créer l'URL utilisée pour appeler CloudWatch et doit être une région Amazon Web Services (AWS) valide. Type : String Valeurs valides : n'importe quelle AWS région, par exemple us-east-1. Par défaut : us-east-1, sauf si la variable d'environnement `EC2_REGION` est définie. | | `S, --secret-key` `VALUE` | La clé d'accès secrète utilisée pour signer la demande, en conjonction avec un identifiant de clé d'accès. Ce paramètre doit être utilisé en conjonction avec `--access-key-id`, sinon cette option est ignorée. Type : String Valeurs valides : votre identifiant de clé d'accès. Par défaut : aucun | | `--show-empty-fields` `` | Affiche les champs vides utilisant (nil) comme espace réservé pour indiquer que ces données n'ont pas été demandées. Type : indicateur Valeurs valides : aucune Par défaut : les champs vides ne sont pas affichés par défaut. | | `--show-request` `` | Affiche l'URL utilisée par l'interface de ligne de commande (CLI) pour appeler AWS. Type : indicateur Valeurs valides : aucune Par défaut : FAUX | | `--show-table, --show-long, --show-xml, --quiet` `` | Spécifie comment les résultats sont affichés : dans une table, délimités (long), XML ou sans sortie (silencieux). L'affichage `--show-table` montre un sous-ensemble des données sous forme de largeur de colonne fixe ; `--show-long` montre toutes les valeurs renvoyées délimitées par un caractère ; `--show-xml` est le rendement brut du service et `--quiet` supprime toutes les sorties standard. Toutes les options sont mutuellement exclusives, avec la priorité `--show-table`, `--show-long`, `--show-xml`, et `--quiet`. Type : indicateur Valeurs valides : aucune Par défaut : `--show-table` | | `-U, --url` `VALUE` | URL utilisée pour contacter CloudWatch. Vous pouvez définir cette valeur à l'aide de la variable d'environnement `AWS_CLOUDWATCH_URL`. Cette valeur est utilisée conjointement avec `--region` pour créer l'URL attendue. Cette option remplace l'URL de l'appel de service. Type : String Valeurs valides : une URL HTTP ou HTTPS valide. Par défaut : utilise la valeur spécifiée dans `AWS_CLOUDWATCH_URL`, si elle est définie. | ## Output Cette commande renvoie un tableau contenant ce qui suit : + ALARM – Nom de l'alarme. + DESCRIPTION – La description de l'alarme. Cette colonne s'affiche uniquement dans la vue tout en long. + STATE – L'état de l'alarme. + STATE\$1REASON – Une raison d'état lisible par les utilisateurs. Cette colonne s'affiche uniquement dans la vue tout en long. + STATE\$1REASON\$1DATA – Une raison lisible par machine pour l'état (format JSON). Cette colonne s'affiche uniquement dans la vue tout en long. + ENABLED – Active ou désactive les actions. Cette colonne s'affiche uniquement dans la vue tout en long. + OK\$1ACTIONS – Action à exécuter sur l'état OK. Cette colonne s'affiche uniquement dans la vue tout en long. + ALARM\$1ACTIONS – Action à exécuter sur l'état ALARM. + INSUFFICIENT\$1DATA\$1ACTIONS – Action à exécuter sur l'état INSUFFICIENT\$1DATA. Cette colonne s'affiche uniquement dans la vue tout en long. + NAMESPACE – Espace de noms pour la métrique. + METRIC\$1NAME – Nom de la métrique. + DIMENSIONS – Dimensions de la métrique. Cette colonne s'affiche uniquement dans la vue tout en long. + PERIOD – Période. + STATISTIQUE - La statistique (moyenne, minimale, maximale, somme, SampleCount). + EXTENDEDSTATIQUE – Statistique des percentiles. + UNIT – Unité. Cette colonne s'affiche uniquement dans la vue tout en long. + EVAL\$1PERIODS – Nombre de périodes pour évaluer la métrique. + COMPARISON – Opérateur de comparaison. + THRESHOLD – Seuil. L'Amazon CloudWatch CLI affiche les erreurs sur stderr. ## Exemples ### Exemple de demande Cet exemple décrit toutes vos alarmes dont le nom commence par my-alarm. ``` mon-describe-alarms --alarm-name-prefix my-alarm --headers ``` Il s'agit d'un exemple de sortie de cette commande. ``` ALARM STATE ALARM_ACTIONS NAMESPACE METRIC_NAME PERIOD STATISTIC EVAL_PERIODS COMPARISON THRESHOLD my-alarm1 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 3 GreaterThanThreshold 100.0 my-alarm2 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 5 GreaterThanThreshold 80o.0 ``` ## Rubriques en relation ### Download + [Configuration de l'interface de ligne de commande](SetupCLI.md) ### Action connexe + [DescribeAlarms](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarms.html) ### Commandes connexes + [mon-describe-alarm-history](cli-mon-describe-alarm-history.md) + [mon-describe-alarms-for-métrique](cli-mon-describe-alarms-for-metric.md)