Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# mon-put-metric-alarm
## Deskripsi
Membuat atau memperbarui alarm dan mengaitkannya dengan CloudWatch metrik yang ditentukan. Anda juga dapat menggunakan perintah ini untuk mengaitkan satu atau beberapa sumber daya Amazon Simple Notiļ¬cation Service (Amazon SNS) dengan sebuah alarm.
Ketika operasi ini menciptakan sebuah alarm, status alarm tersebut langsung diatur ke INSUFFICIENT\$1DATA. Alarm dievaluasi dan StateValue diatur dengan tepat. Setiap tindakan yang terkait dengan kemudian StateValue dieksekusi.
**catatan**
Saat memperbarui alarm yang ada, StateValue dibiarkan tidak berubah.
## Sintaksis
****mon-put-metric-alarm** AlarmName --comparison-operator *value* --evaluation-periods *value* --metric-name *value* --namespace *value* --period *value* [--statistic *value*] [--extendedstatistic *value*] --threshold *value* [--actions-enabled *value*] [--alarm-actions *value*[,*value*...] ] [--alarm-description *value*] [--dimensions "key1=*value1*,key2=*value2*..."] [--ok-actions *value*[,*value*...] ] [--unit *value*] [--insufficient-data-actions *value*[,*value*...]] [Common Options] **
## Opsi
| Nama | Deskripsi |
| --- | --- |
| `AlarmName` `` | Nama alarm yang akan diperbarui atau dibuat. Nama harus unik di AWS akun Anda. Anda juga dapat mengatur nilai ini dengan menggunakan `--alarm-name`. Tipe: Argumen Nilai valid: String UTF-8. Bawaan: Tidak ada Wajib: Ya |
| `--actions-enabled` `VALUE` | Menunjukkan apakah tindakan harus dilaksanakan ketika status alarm berubah, atau tidak. Tipe: Boolean Nilai valid: Betul atau Salah Bawaan: BETUL Wajib: Tidak |
| `--alarm-actions` `VALUE1,VALUE2,VALUE3... ` | Tindakan (hingga lima) yang akan dijalankan ketika alarm ini bertransisi dari status lainnya ke status ALARM. Setiap tindakan ditentukan sebagai Amazon Resource Name (ARN). Dengan menggunakan tindakan alarm, Anda dapat memublikasikan ke topik Amazon SNS, mengaktifkan kebijakan Auto EC2 Scaling Amazon, atau menghentikan, menghentikan, atau memulihkan instans Amazon. EC2 Jika Anda menggunakan akun AWS Identity and Access Management (IAM) untuk membuat atau memodifikasi alarm, Anda harus memiliki EC2 izin Amazon berikut: `ec2:DescribeInstanceStatus`dan `ec2:DescribeInstances` untuk semua alarm di metrik status EC2 instans Amazon. `ec2:StopInstances` untuk alarm dengan tindakan berhenti. `ec2:TerminateInstances` untuk alarm dengan tindakan mengakhiri. `ec2:DescribeInstanceRecoveryAttribute`, dan `ec2:RecoverInstances` untuk alarm dengan tindakan pemulihan. Jika Anda memiliki read/write izin untuk Amazon CloudWatch tetapi tidak untuk Amazon EC2, Anda masih dapat membuat alarm tetapi tindakan berhenti atau menghentikan tidak akan dilakukan pada instans Amazon EC2 . Namun, jika Anda kemudian diberikan izin untuk menggunakan Amazon terkait EC2 APIs, tindakan alarm yang Anda buat sebelumnya akan dilakukan. Untuk informasi selengkapnya tentang izin IAM, silakan lihat [Izin dan Kebijakan](https://docs.aws.amazon.com/IAM/latest/UserGuide/PermissionsAndPolicies.html) dalam *Panduan Pengguna IAM*. Jika Anda menggunakan peran IAM (misalnya, profil EC2 instans Amazon), Anda tidak dapat menghentikan atau menghentikan instance menggunakan tindakan alarm. Namun, Anda masih dapat melihat status alarm dan melakukan tindakan lain seperti pemberitahuan Amazon SNS atau kebijakan Amazon Auto EC2 Scaling. Jika Anda menggunakan kredenal keamanan sementara yang diberikan menggunakan AWS Security Token Service (AWS STS), Anda tidak dapat menghentikan atau menghentikan EC2 instans Amazon menggunakan tindakan alarm. Tipe: String Nilai yang valid: ARN untuk topik Amazon SNS, kebijakan Auto Scaling, atau ARN untuk menghentikan, menghentikan, atau memulihkan instans Amazon. EC2 Bawaan: Tidak ada Wajib: Tidak |
| `--alarm-description` `VALUE` | Deskripsi alarm. Tipe: String Nilai valid: Setiap string Unicode yang memiliki panjang antara 1 dan 255 karakter. Bawaan: Tidak ada Wajib: Tidak |
| `--comparison-operator` `VALUE` | Operator perbandingan yang digunakan untuk membandingkan titik data dengan ambang batas. Tipe: Pencacahan Nilai yang valid: salah satu dari GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, atau LessThanOrEqualToThreshold Bawaan: Tidak ada Wajib: Ya |
| `--dimensions` `"key1=value1,key2=value2..."` | Dimensi metrik yang akan dibuat yang ingin Anda buat alarmnya. Anda dapat menentukan dimensi dengan menggunakan dua cara dan formatnya dapat digabungkan atau digunakan secara saling menggantikan: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonCloudWatch/latest/cli/cli-mon-put-metric-alarm.html) Tipe: Peta Nilai valid: String dengan format nama=nilai, di mana kuncinya adalah nama dimensi, dan nilainya adalah nilai dari dimensi. Nama dimensi, dan nilai harus berupa rangkaian ANSI yang memiliki panjang antara 1 dan 250 karakter. Diperbolehkan maksimal 10 dimensi. Bawaan: Tidak ada Wajib: Tidak |
| `--evaluation-periods` `VALUE` | Jumlah periode berturut-turut di mana nilai metriknya dibandingkan dengan ambang batas untuk menentukan status alarm. Tipe: Integer Nilai valid: Angka yang lebih besar dari nol. Bawaan: Tidak ada Wajib: Ya |
| `--metric-name` `VALUE` | Nama metrik untuk mengaktifkan alarm. Tipe: Argumen Nilai valid: String ANSI yang memiliki panjang antara 1 dan 250 karakter. Bawaan: Tidak ada Wajib: Ya |
| `--namespace` `VALUE` | Ruang nama metrik untuk mengaktifkan alarm. Untuk informasi selengkapnya tentang ruang nama, silakan lihat [AWS Namespaces](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html). Tipe: String Nilai valid: String ANSI yang memiliki panjang antara 1 dan 250 karakter. Bawaan: Tidak ada Wajib: Ya |
| `--ok-actions` `VALUE1,VALUE2,VALUE3...` | Tindakan (hingga lima) yang akan dijalankan ketika alarm ini beralih dari status lainnya ke status OK. Setiap tindakan ditentukan sebagai Amazon Resource Name (ARN). Tipe: String Nilai valid: Pengidentifikasi ARN yang valid. Bawaan: Tidak ada Wajib: Tidak |
| `--period` `VALUE` | Periode metrik untuk mengaktifkan alarm (dalam detik). Tipe: Argumen Nilai valid: Sebuah angka, dalam satuan detik, yang merupakan kelipatan dari 60 detik. Bawaan: Tidak ada Wajib: Ya |
| `--statistic` `VALUE` | Statistik metrik untuk mengaktifkan alarm. Tipe: Pencacahan Nilai yang valid: SampleCount, Rata-rata, Jumlah, Minimum, atau Maksimum Bawaan: Tidak ada Wajib: Anda harus menentukan --statistik atau --extendedstatistic. |
| `--extendedstatistic` `VALUE` | Statistik persentil metrik untuk mengaktifkan alarm. Tipe: String Nilai valid: Setiap persentil, dengan maksimal dua tempat desimal (misalnya, hal95.45). Bawaan: Tidak ada Wajib: Anda harus menentukan --statistik atau --extendedstatistic. |
| `--threshold` `VALUE` | Ambang batas yang dibandingkan dengan titik data untuk menentukan status alarm. Tipe: Ganda Nilai valid: Sebuah nilai ganda. Semua nilai harus berupa angka antara 1E-130 dan 1E130. Bawaan: Tidak ada Wajib: Ya |
| `--unit` `VALUE` | Unit metrik untuk mengaktifkan alarm. Tipe: Pencacahan Nilai valid: Gunakan salah satu nilai berikut ini: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonCloudWatch/latest/cli/cli-mon-put-metric-alarm.html) Bawaan: Tidak ada Wajib: Tidak |
| `--insufficient-data-actions` `VALUE1,VALUE2,VALUE3...` | Tindakan (hingga lima) yang akan dijalankan ketika alarm ini beralih dari status apa pun lainnya menjadi status INSUFFICIENT\$1DATA. Setiap tindakan ditentukan sebagai Amazon Resource Name (ARN). Tipe: String Nilai valid: Pengidentifikasi ARN yang valid. Bawaan: Tidak ada Wajib: Tidak |
## Opsi umum
| 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
Perintah ini akan membuat atau memperbarui alarm yang terkait dengan metrik tertentu.
Amazon CloudWatch CLI menampilkan kesalahan pada stderr.
## Contoh
### Contoh permintaan
Contoh ini membuat alarm yang menerbitkan pesan ke topik ketika penggunaan CPU dari suatu EC2 instance melebihi 90 persen selama tiga periode satu menit berturut-turut.
```
mon-put-metric-alarm --alarm-name my-alarm --alarm-description "some desc" \
--metric-name CPUUtilization --namespace AWS/EC2 --statistic Average --period 60 --threshold 90 \
--comparison-operator GreaterThanThreshold --dimensions InstanceId=i-abcdef --evaluation-periods 3 \
--unit Percent --alarm-actions arn:aws:sns:us-east-1:1234567890:my-topic
```
## Topik terkait
### Unduh
+ [Menyiapkan antarmuka baris perintah](SetupCLI.md)
### Tindakan terkait
+ [PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)
### Perintah terkait
+ [mon-put-data](cli-mon-put-data.md)