

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# mon-describe-alarms
<a name="cli-mon-describe-alarms"></a>

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

Ottiene informazioni sugli allarmi specificati. Se non specifichi un nome di allarme, questo comando restituisce informazioni relative a tutti gli allarmi. Puoi recuperare gli allarmi utilizzando solo il prefisso del nome di allarme, lo stato dell'allarme oppure un prefisso operazione.

## Sintassi
<a name="w2aab9c23b5"></a>

 ****mon-describe-alarms** [AlarmNames [{{AlarmNames}} ...]] [--action-prefix {{value}}] [--alarm-name-prefix {{value}}] [--state-value {{value}}] [Common Options]** 

## Opzioni
<a name="w2aab9c23b7"></a>


| Nome | Description | 
| --- | --- | 
| `AlarmNames` `AlarmNames` | I nomi degli allarmi. Puoi anche impostare questo valore utilizzando `--alarm-name`. Puoi specificare questa opzione più volte.<br />Tipo: argomento<br />Valori validi: un nome di allarme esistente, altrimenti non viene restituita alcun risposta.<br />Impostazione predefinita: n/d, visualizza tutti gli allarmi per impostazione predefinita.<br />Campo obbligatorio: no | 
|  `--action-prefix` `VALUE`  | Prefisso di nomi di operazioni.<br />Tipo: argomento<br />Valori validi: il prefisso di un nome di operazione esistente, in formato ARN.<br />Impostazione predefinita: n/d, visualizza la prima operazione per impostazione predefinita.<br />Campo obbligatorio: no | 
|  `--alarm-name-prefix` `VALUE`  | Prefisso di nomi di allarmi.<br />Tipo: argomento<br />Valori validi: il prefisso di un nome di allarme esistente.<br />Impostazione predefinita: n/d<br />Campo obbligatorio: no | 
|  `--state-value` `VALUE`  | Lo stato di un allarme.<br />Tipo: enumerazione<br />Valori validi: OK, ALARM, o INSUFFICIENT\_DATA<br />Impostazione predefinita: tutti gli stati degli allarmi.<br />Campo obbligatorio: no | 

## Opzioni comuni
<a name="w2aab9c23b9"></a>


| Nome | Description | 
| --- | --- | 
| `--aws-credential-file` `VALUE`  | La posizione del file con le tue AWS credenziali. È possibile impostare questo valore utilizzando la variabile di ambiente `AWS_CREDENTIAL_FILE`. Se si definisce la variabile di ambiente o si specifica il percorso del file delle credenziali, il file deve esistere o la richiesta avrà esito negativo. Tutte le CloudWatch richieste devono essere firmate utilizzando l'ID della chiave di accesso e la chiave di accesso segreta.<br />Tipo: stringa<br />Valori validi: un percorso valido di un file contenente l'ID chiave di accesso e la chiave di accesso segreta.<br />Impostazione predefinita: utilizza la variabile di ambiente `AWS_CREDENTIAL_FILE`, se impostata. | 
| `-C, --ec2-cert-file-path` `VALUE`  | La posizione del file di EC2 certificato per la firma delle richieste. Puoi usare la variabile di ambiente `EC2_CERT` per specificare questo valore.<br />Tipo: stringa<br />Valori validi: un percorso di file valido per il file PEM fornito da Amazon EC2 o AWS Identity and Access Management.<br />Impostazione predefinita: utilizza la variabile di ambiente `EC2_CERT`, se impostata. | 
|  `--connection-timeout` `VALUE`  | Il valore del tempo di connessione (in secondi).<br />Tipo: numero intero<br />Valori validi: qualsiasi numero positivo.<br />Impostazione predefinita: 30 | 
|  `--delimiter` `VALUE`  | Il delimitatore da utilizzare quando si visualizzano risultati (lunghi) delimitati.<br />Tipo: stringa<br />Valori validi: qualsiasi stringa.<br />Impostazione predefinita: virgola (,) | 
|  `--headers` ``  | Se si visualizzano risultati tabulari o delimitati, includere le intestazioni di colonna. Se si visualizzano risultati in XML, restituire le intestazioni HTTP dalla richiesta di servizio, se applicabile.<br />Tipo: flag<br />Valori validi: quando presenti, mostra le intestazioni.<br />Impostazione predefinita: l'opzione `--headers` è disattivata per impostazione predefinita. | 
|  `-I, --access-key-id` `VALUE`  | L'ID chiave di accesso che verrà utilizzato insieme alla chiave segreta per firmare la richiesta. Questo deve essere utilizzato insieme alla chiave segreta, altrimenti l'opzione viene ignorata. Tutte le richieste CloudWatch devono essere firmate, altrimenti la richiesta viene rifiutata.<br />Tipo: stringa<br />Valori validi: un ID chiave di accesso valido.<br />Impostazione predefinita: nessuna | 
|  `-K, --ec2-private-key-file-path` `VALUE`  | La chiave privata che verrà utilizzata per firmare la richiesta. L'uso public/private delle chiavi fa sì che la CLI utilizzi SOAP. La richiesta viene firmata con un certificato pubblico e una chiave privata. Questo parametro deve essere utilizzato in combinazione con `EC2_CERT`, altrimenti il valore viene ignorato. Il valore della variabile di ambiente `EC2_PRIVATE_KEY` verrà utilizzato se è impostata e questa opzione non è specificata. Questa opzione viene ignorata se la variabile di ambiente `AWS_CREDENTIAL_FILE` è impostata, oppure viene utilizzato il `--aws-credentials-file`. Tutte le richieste CloudWatch devono essere firmate, altrimenti la richiesta viene rifiutata.<br />Tipo: stringa<br />Valori validi: il percorso di una chiave privata ASN.1 valida.<br />Impostazione predefinita: nessuna | 
|  `--region` `VALUE`  | La regione a cui sono indirizzate le richieste. Per specificare il valore è possibile utilizzare la variabile di ambiente `EC2_REGION`. La regione viene utilizzata per creare l'URL utilizzato per la chiamata CloudWatch e deve essere una regione Amazon Web Services (AWS) valida.<br />Tipo: stringa<br />Valori validi: qualsiasi AWS regione, ad esempio us-east-1.<br />Impostazione predefinita: us-east-1, a meno che non sia impostata la variabile `EC2_REGION`. | 
|  `S, --secret-key` `VALUE`  | La chiave di accesso segreta che verrà utilizzata insieme all'ID chiave di accesso per firmare la richiesta. Questo parametro deve essere utilizzato in combinazione con `--access-key-id`, altrimenti l'opzione viene ignorata.<br />Tipo: stringa<br />Valori validi: l'ID chiave di accesso.<br />Impostazione predefinita: nessuna | 
|  `--show-empty-fields` ``  | Mostra i campi vuoti utilizzando (nullo) come placeholder per indicare che questi dati non sono stati richiesti.<br />Tipo: flag<br />Valori validi: None<br />Impostazione predefinita: i campi vuoti non vengono mostrati per impostazione predefinita. | 
|  `--show-request` ``  | Visualizza l'URL utilizzato dalla CLI per chiamare AWS.<br />Tipo: flag<br />Valori validi: None<br />Impostazione predefinita: false | 
|  `--show-table, --show-long, --show-xml, --quiet` ``  | Specifica la modalità di visualizzazione dei risultati: in tabella, delimitati (lungo), XML o nessun output (silenzio). `--show-table` mostra un sottoinsieme dei dati sotto forma di colonna a larghezza fissa; `--show-long` mostra tutti i valori restituiti delimitati da un carattere; `--show-xml` è il risultato grezzo restituito dal servizio; e `--quiet` sopprime tutti gli output standard. Tutte le opzioni si escludono a vicenda, con la priorità a `--show-table`, `--show-long`, `--show-xml` e `--quiet`.<br />Tipo: flag<br />Valori validi: None<br />Impostazione predefinita: `--show-table` | 
|  `-U, --url` `VALUE`  | L'URL utilizzato per contattare. CloudWatch È possibile impostare questo valore utilizzando la variabile di ambiente `AWS_CLOUDWATCH_URL`. Questo valore viene utilizzato in combinazione con `--region` per creare l'URL previsto. Questa opzione sostituisce l'URL della chiamata di servizio.<br />Tipo: stringa<br />Valori validi: un URL HTTP o HTTPS valido.<br />Impostazione predefinita: utilizza il valore specificato in `AWS_CLOUDWATCH_URL`, se impostato. | 

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

Questo comando restituisce una tabella contenente quanto segue:
+ ALARM – Nome dell'allarme.
+ Descrizione - La descrizione dell'allarme. Questa colonna appare solo nella visualizzazione -show-long.
+ STATO - Lo stato dell'allarme.
+ STATE\_REASON - Un motivo per lo stato in formato leggibile. Questa colonna appare solo nella visualizzazione -show-long.
+ STATE\_REASON\_DATA - Un motivo leggibile dalla macchina per lo stato (formato JSON). Questa colonna appare solo nella visualizzazione -show-long.
+ ENABLED - Abilita o disabilita le azioni. Questa colonna appare solo nella visualizzazione -show-long.
+ OK\_ACTIONS - L'azione da eseguire sullo stato OK. Questa colonna appare solo nella visualizzazione -show-long.
+ ALARM\_ACTIONS - L'azione da eseguire sullo stato ALARM.
+ INSUFFICIENT\_DATA\_ACTIONS - L'azione da eseguire sullo stato INSUFFICIENT\_DATA. Questa colonna appare solo nella visualizzazione -show-long.
+ NAMESPACE - uno spazio dei nomi per il parametro.
+ METRIC\_NAME - Il nome del parametro.
+ DIMENSIONI - Le dimensioni del parametro. Questa colonna appare solo nella visualizzazione -show-long.
+ PERIODO - Il periodo.
+ STATISTICA: la statistica (media, minima, massima, somma, SampleCount).
+ EXTENDEDSTATISTIC - La statistica percentile.
+ UNIT - L'unità. Questa colonna appare solo nella visualizzazione -show-long.
+ EVAL\_PERIODIS - Il numero di periodi per valutare il parametro.
+ COMPARISON - L'operatore di confronto.
+ SOGLIA - La soglia.

L'Amazon CloudWatch CLI mostra gli errori su stderr.

## Esempi
<a name="w2aab9c23c13"></a>

### Richiesta di esempio
<a name="w2aab9c23c13b2"></a>

Questo esempio descrive tutti gli allarmi i cui nomi iniziano con my-alarm.

```
mon-describe-alarms --alarm-name-prefix my-alarm --headers
```

Questo è un esempio di output di questo comando.

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

## Argomenti correlati
<a name="w2aab9c23c15"></a>

### Scarica
<a name="w2aab9c23c15b2"></a>
+ [Impostazione dell'interfaccia a riga di comando](SetupCLI.md)

### Operazione correlata
<a name="w2aab9c23c15b4"></a>
+ [DescribeAlarms](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarms.html)

### Comandi correlati
<a name="w2aab9c23c15b6"></a>
+  [mon-describe-alarm-history](cli-mon-describe-alarm-history.md) 
+  [mon-describe-alarms-for-metrico](cli-mon-describe-alarms-for-metric.md) 