

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

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

Dapatkan informasi tentang alarm tertentu. Jika Anda tidak menyebutkan nama alarm, maka perintah ini akan mengembalikan informasi tentang semua alarm Anda. Anda dapat mengambil alarm hanya dengan menggunakan awalan nama alarm, status alarm, atau awalan tindakan.

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

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

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


| Nama | Deskripsi | 
| --- | --- | 
|  `AlarmNames` `AlarmNames`  |  Nama-nama alarm. Anda juga dapat mengatur nilai ini menggunakan `--alarm-name`. Anda dapat menentukan opsi ini beberapa kali. Tipe: Argumen Nilai valid: Nama alarm yang sudah ada, jika tidak, maka tidak akan ada respons yang dikembalikan. Bawaan: Tidak tersedia, secara bawaan, akan menampilkan semua alarm. Wajib: Tidak  | 
|   `--action-prefix` `VALUE`   |  Awalan dari nama-nama tindakan. Tipe: Argumen Nilai valid: Awalan dari sebuah nama tindakan yang sudah ada, dalam format ARN. Bawaan: Tidak tersedia, secara bawaan, akan menampilkan tindakan yang pertama. Wajib: Tidak  | 
|   `--alarm-name-prefix` `VALUE`   |  Awalan dari nama-nama alarm. Tipe: Argumen Nilai valid: Awalan dari sebuah nama alarm yang sudah ada. Bawaan: Tidak ada Wajib: Tidak  | 
|   `--state-value` `VALUE`   |  Status alarm. Tipe: Pencacahan Nilai valid: OK, ALARM, atau INSUFFICIENT\$1DATA Bawaan: Semua status alarm. Wajib: Tidak  | 

## Opsi umum
<a name="w2aab9c23b9"></a>


| Nama | Deskripsi | 
| --- | --- | 
|  `--aws-credential-file` `VALUE`   |  Lokasi file dengan AWS kredensi Anda. Anda dapat mengatur nilai ini dengan menggunakan variabel lingkungan `AWS_CREDENTIAL_FILE`. Jika Anda menentukan variabel lingkungan atau memberikan jalur ke file kredensial, maka file tersebut harus ada, jika tidak, maka permintaan gagal. Semua CloudWatch permintaan harus ditandatangani menggunakan ID kunci akses dan kunci akses rahasia Anda. Tipe: String Nilai valid: Jalur yang valid ke file yang berisi ID kunci akses dan kunci akses rahasia. Bawaan: Menggunakan variabel lingkungan `AWS_CREDENTIAL_FILE`, jika diatur.  | 
|  `-C, --ec2-cert-file-path` `VALUE`   |  Lokasi file EC2 sertifikat Anda untuk menandatangani permintaan. Anda dapat menggunakan variabel lingkungan `EC2_CERT` untuk menentukan nilai ini. Tipe: String Nilai yang valid: Jalur file yang valid ke file PEM yang disediakan oleh Amazon EC2 atau AWS Identity and Access Management. Bawaan: Menggunakan variabel lingkungan `EC2_CERT`, jika diatur.  | 
|   `--connection-timeout` `VALUE`   |  Nilai waktu habis koneksi, menggunakan satuan detik. Tipe: Integer Nilai valid: Semua angka positif. Bawaan: 30  | 
|   `--delimiter` `VALUE`   |  Pembatas yang digunakan ketika menampilkan hasil yang dibatasi (panjang). Tipe: String Nilai valid: Semua string. Bawaan: Koma (,)  | 
|   `--headers` ``   |  Jika Anda menampilkan hasil dalam bentuk tabel atau dipisahkan, maka Anda harus menyertakan header kolom. Jika Anda menunjukkan hasil XML, maka Anda harus mengembalikan header HTTP dari permintaan layanan, jika ada. Tipe: Bendera Nilai valid: Jika ada, tampilkan header. Bawaan: Pilihan `--headers` secara default tidak aktif.  | 
|   `-I, --access-key-id` `VALUE`   |  ID kunci akses yang akan digunakan, bersama dengan kunci rahasia, untuk menandatangani permintaan. Ini harus digunakan bersamaan dengan --kunci rahasia, jika tidak, maka pilihan yang bersangkutan akan diabaikan. Semua permintaan CloudWatch harus ditandatangani, jika tidak permintaan ditolak. Tipe: String Nilai valid: ID kunci akses yang benar. Bawaan: Tidak Ada  | 
|   `-K, --ec2-private-key-file-path` `VALUE`   |  Kunci privat yang akan digunakan untuk menandatangani permintaan. Menggunakan public/private kunci menyebabkan CLI menggunakan SOAP. Permintaan tersebut ditandatangani dengan sertifikat publik dan kunci privat. Parameter ini harus digunakan bersamaan dengan `EC2_CERT`, jika tidak, maka nilainya akan diabaikan. Nilai variabel lingkungan `EC2_PRIVATE_KEY` akan digunakan jika memang diatur untuk menggunakan nilai itu, dan pilihan ini tidak ditentukan. Pilihan ini akan diabaikan jika variabel lingkungan `AWS_CREDENTIAL_FILE` telah ditetapkan, atau jika `--aws-credentials-file` digunakan. Semua permintaan CloudWatch harus ditandatangani, jika tidak permintaan ditolak. Tipe: String Nilai valid: Jalur ke kunci privat ASN.1 yang benar. Bawaan: Tidak Ada  | 
|   `--region` `VALUE`   |  Permintaan wilayah diarahkan ke. Anda dapat menggunakan variabel lingkungan `EC2_REGION` untuk menentukan nilai tersebut. Wilayah ini digunakan untuk membuat URL yang digunakan untuk memanggil CloudWatch, dan harus merupakan wilayah Amazon Web Services (AWS) yang valid. Tipe: String Nilai yang valid: Setiap AWS wilayah, misalnya, us-east-1. Bawaan: us-east-1, kecuali jika `EC2_REGION` variabel lingkungan sudah ditetapkan.  | 
|   `S, --secret-key` `VALUE`   |  Kunci akses rahasia yang akan digunakan bersama dengan ID kunci akses untuk menandatangani permintaan. Parameter ini harus digunakan bersamaan dengan `--access-key-id`, jika tidak, maka pilihan ini akan diabaikan. Tipe: String Nilai valid: ID kunci akses Anda. Bawaan: Tidak Ada  | 
|   `--show-empty-fields` ``   |  Menampilkan bidang kosong menggunakan (nil) sebagai placeholder untuk menunjukkan bahwa data ini tidak diminta. Tipe: Bendera Nilai valid: Tidak ada Bawaan: Secara bawaan, bidang yang kosong tidak ditampilkan.  | 
|   `--show-request` ``   |  Menampilkan URL yang digunakan oleh CLI untuk memanggil AWS. Tipe: Bendera Nilai valid: Tidak ada Bawaan: salah  | 
|   `--show-table, --show-long, --show-xml, --quiet` ``   |  Menentukan bagaimana hasil ditampilkan: dalam bentuk tabel, dibatasi (panjang), XML, atau tidak ada output (diam). Tampilan `--show-table` menunjukkan bagian dari data dalam bentuk lebar kolom tetap; `--show-long` menunjukkan semua nilai yang dikembalikan yang dibatasi oleh sebuah karakter; `--show-xml` adalah pengembalian mentah dari layanan; dan `--quiet` menekan semua output yang standar. Semua pilihan tidak dapat dipilih bersamaan, dengan prioritas `--show-table`, `--show-long`, `--show-xml`, dan `--quiet`. Tipe: Bendera Nilai valid: Tidak ada Default: `--show-table`  | 
|   `-U, --url` `VALUE`   |  URL yang digunakan untuk menghubungi CloudWatch Anda dapat mengatur nilai ini dengan menggunakan variabel lingkungan `AWS_CLOUDWATCH_URL`. Nilai ini digunakan secara bersamaan dengan `--region` untuk membuat URL yang diharapkan. Pilihan ini menimpa URL untuk panggilan layanan. Tipe: String Nilai valid: URL HTTP atau HTTPS yang valid. Bawaan: Menggunakan nilai yang ditentukan dalam `AWS_CLOUDWATCH_URL`, jika sudah diatur.  | 

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

Perintah ini akan menampilkan sebuah tabel yang memuat hal-hal berikut:
+ ALARM - Nama alarm.
+ DESCRIPTION - Deskripsi alarm. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang.
+ STATE - Status alarm.
+ STATE\$1REASON - Alasan status yang dapat dibaca manusia. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang.
+ STATE\$1REASON\$1DATA - Alasan status yang dapat dibaca mesin (format SON). Kolom ini hanya muncul dalam tampilan --tampilkan-panjang.
+ ENABLED - Mengaktifkan atau menonaktifkan tindakan. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang.
+ OK\$1ACTIONS - Tindakan untuk menjalankan status OK. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang.
+ ALARM\$1ACTIONS - Tindakan untuk menjalankan status ALARM.
+ INSUFFICIENT\$1DATA\$1ACTION - Tindakan untuk menjalankan status INSUFFICIENT\$1DATA. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang.
+ NAMESPACE - Ruang nama untuk metrik.
+ METRIC\$1NAME - Nama metrik.
+ DIMENSIONS - Dimensi metrik. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang.
+ PERIOD - Periode.
+ Statistik - Statistik (Rata-rata, Minimum, Maksimum, Jumlah, SampleCount).
+ EXTENDEDSTATISTIC - Statistik persentil.
+ UNIT - Unit. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang.
+ EVAL\$1PERIODS - Jumlah periode untuk mengevaluasi metrik.
+ COMPARISON - Operator perbandingan.
+ THRESHOLD - Ambang batas.

Amazon CloudWatch CLI menampilkan kesalahan pada stderr.

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

### Contoh permintaan
<a name="w2aab9c23c13b2"></a>

Contoh ini mendeskripsikan semua alarm Anda yang namanya diawali dengan my-alarm.

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

Ini adalah contoh keluaran dari perintah ini.

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

## Topik terkait
<a name="w2aab9c23c15"></a>

### Unduh
<a name="w2aab9c23c15b2"></a>
+ [Menyiapkan antarmuka baris perintah](SetupCLI.md)

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

### Perintah-perintah terkait
<a name="w2aab9c23c15b6"></a>
+  [mon-describe-alarm-history](cli-mon-describe-alarm-history.md) 
+  [mon-describe-alarms-for-metrik](cli-mon-describe-alarms-for-metric.md) 