

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-list-metrics
<a name="cli-mon-list-metrics"></a>

## Description
<a name="w2aab9c43b3"></a>

Permet de répertorier les noms, les espaces de noms et les dimensions des métriques associées à votre compte AWS . Vous pouvez filtrer les métriques à l'aide de n'importe quelle combinaison de nom de métrique, d'espace de noms ou de dimensions. Si vous ne spécifiez pas de filtre, toutes les correspondances possibles pour l'attribut sont renvoyées.

**Note**  
La mon-list-metrics commande peut prendre jusqu'à quinze minutes pour signaler les nouveaux noms de métriques, espaces de noms et dimensions ajoutés par les appels à`mon-put-data`. Les points de données placés par `mon-put-data` ou d'autres méthodes seront rendus disponibles par `mon-get-statistics` en moins de cinq minutes.

## Syntaxe
<a name="w2aab9c43b5"></a>

 ****mon-list-metrics** [--dimensions "key1={{value1}},key2={{value2}}..."] [--metric-name {{value}}] [--namespace {{value}}] [Common Options] ** 

## Options
<a name="w2aab9c43b7"></a>


| Nom | Description | 
| --- | --- | 
| -d, --dimensions `"key1=value1,key2=value2..."`  | Dimensions de la métrique à récupérer. Vous pouvez spécifier les dimensions de deux manières et les formats peuvent être combinés ou utilisés de façon interchangeable :[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/AmazonCloudWatch/latest/cli/cli-mon-list-metrics.html)<br />Si aucune dimension n'est spécifiée, aucun filtrage de dimensions ne sera effectué. Tous les autres filtres demandés seront toujours appliqués. Pour être inclus dans le résultat, une métrique doit contenir toutes les dimensions spécifiées, même si la métrique peut contenir des dimensions supplémentaires au-delà des métriques demandées.<br />Type : carte<br />Valeurs valides : une chaîne au format name=value, où la clé est le nom de la dimension et la valeur est la valeur de la dimension. Les noms de dimension et les valeurs doivent être une chaîne ANSI comportant entre 1 et 250 caractères. 10 dimensions au maximum sont autorisées.<br />Par défaut : S.o.<br />Obligatoire : non | 
| `-m, --metric-name` `VALUE`  | Le nom de la métrique. Pour être inclus dans les résultats, le nom de la métrique doit correspondre exactement au nom de la métrique demandée. Si aucun nom de métrique n'est spécifié, aucun filtrage n'est effectué. Tous les autres filtres demandés sont appliqués.<br />Type : simple<br />Valeurs valides : tout nom de métrique valide comportant entre 1 et 250 caractères.<br />Par défaut : S.o.<br />Obligatoire : non | 
| `-n, --namespace` ` VALUE`  | Espace de noms à utiliser pour filtrer les métriques. Pour plus d'informations sur les espaces de noms, consultez [AWS Espaces de noms](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html).<br />Type : String<br />Valeurs valides : espace de noms valide comportant entre 1 et 250 caractères.<br />Par défaut : S.o.<br />Obligatoire : non | 

## Options courantes
<a name="w2aab9c43b9"></a>


| 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.<br />Type : String<br />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.<br />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.<br />Type : String<br />Valeurs valides : chemin de fichier valide vers le fichier PEM fourni par Amazon EC2 ou Gestion des identités et des accès AWS.<br />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.<br />Type : Integer<br />Valeurs valides : tout nombre positif.<br />Valeur par défaut : 30 | 
|  `--delimiter` `VALUE`  | Le délimiteur à utiliser lors de l'affichage des résultats délimités (longs).<br />Type : String<br />Valeurs valides : toute chaîne.<br />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.<br />Type : indicateur<br />Valeurs valides : lorsqu'elles sont présentes, affiche les en-têtes.<br />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.<br />Type : String<br />Valeurs valides : un identifiant de clé d'accès valide.<br />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.<br />Type : String<br />Valeurs valides : chemin d'accès à une clé privée ASN.1 valide.<br />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.<br />Type : String<br />Valeurs valides : n'importe quelle AWS région, par exemple us-east-1.<br />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.<br />Type : String<br />Valeurs valides : votre identifiant de clé d'accès.<br />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.<br />Type : indicateur<br />Valeurs valides : aucune<br />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.<br />Type : indicateur<br />Valeurs valides : aucune<br />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`.<br />Type : indicateur<br />Valeurs valides : aucune<br />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.<br />Type : String<br />Valeurs valides : une URL HTTP ou HTTPS valide.<br />Par défaut : utilise la valeur spécifiée dans `AWS_CLOUDWATCH_URL`, si elle est définie. | 

## Output
<a name="w2aab9c43c11"></a>

Cette commande renvoie un tableau contenant ce qui suit :
+ Nom de métrique - Nom de la métrique associée à cette métrique.
+ Espace de noms - Espace de noms associé à cette métrique.
+ Dimensions - Noms et valeurs de dimension associés à cette métrique.

L'Amazon CloudWatch CLI affiche les erreurs sur stderr.

## Exemples
<a name="w2aab9c43c13"></a>

### Exemple de demande
<a name="w2aab9c43c13b2"></a>

Cet exemple renvoie une liste de toutes vos métriques.

```
mon-list-metrics 
```

Il s'agit d'un exemple de sortie d'un appel à « mon-list-metrics ».

```
Metric Name                 Namespace  Dimensions
CPUUtilization               AWS/EC2    {InstanceId=i-e7e48a8e}
CPUUtilization               AWS/EC2    {InstanceId=i-231d744a}
CPUUtilization               AWS/EC2    {InstanceId=i-22016e4b}
CPUUtilization               AWS/EC2    {InstanceId=i-b0345cd9}
CPUUtilization               AWS/EC2    {InstanceId=i-539dff3a}
CPUUtilization               AWS/EC2    {InstanceId=i-af3544c6}
CPUUtilization               AWS/EC2    {InstanceId=i-d4f29ebd}
CPUUtilization               AWS/EC2    {ImageId=ami-de4daab7}
...
```

### Exemple de demande
<a name="w2aab9c43c13b4"></a>

Cet exemple répertorie vos métriques avec le nom spécifié.

```
mon-list-metrics --metric-name RequestCount
```

### Exemple de demande
<a name="w2aab9c43c13b6"></a>

Cet exemple répertorie vos métriques appartenant à l'espace de noms spécifié.

```
mon-list-metrics --namespace MyService
```

### Exemple de demande
<a name="w2aab9c43c13b8"></a>

Cet exemple répertorie vos métriques avec les noms et valeurs de dimension spécifiés.

```
mon-list-metrics --dimensions "User=SomeUser,Stack=Test"
```

## Rubriques en relation
<a name="w2aab9c43c15"></a>

### Download
<a name="w2aab9c43c15b2"></a>
+ [Configuration de l'interface de ligne de commande](SetupCLI.md)

### Action connexe
<a name="w2aab9c43c15b4"></a>
+ [ListMetrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_ListMetrics.html)

### Commande connexe
<a name="w2aab9c43c15b6"></a>
+  [mon-describe-alarms](cli-mon-describe-alarms.md) 