mon-describe-alarms - Amazon CloudWatch

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

mon-describe-alarms

Deskripsi

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

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

Opsi

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_DATA

Bawaan: Semua status alarm.

Wajib: Tidak

Opsi umum

Nama Penjelasan

--aws-credential-file VALUE

Lokasi file dengan AWS kredensil 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.

Jenis: 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 sertifikat EC2 Anda untuk menandatangani semua permintaan. Anda dapat menggunakan variabel lingkungan EC2_CERT untuk menentukan nilai ini.

Jenis: String

Nilai yang valid: Jalur file yang valid ke file PEM yang disediakan oleh Amazon AWS Identity and Access Management EC2 atau.

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.

Jenis: 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. Penggunaan kunci publik/privat akan membuat 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.

Jenis: 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.

Jenis: 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

Bawaan: --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 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_REASON - Alasan status yang dapat dibaca manusia. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang.

  • STATE_REASON_DATA - 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_ACTIONS - Tindakan untuk menjalankan status OK. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang.

  • ALARM_ACTIONS - Tindakan untuk menjalankan status ALARM.

  • INSUFFICIENT_DATA_ACTION - Tindakan untuk menjalankan status INSUFFICIENT_DATA. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang.

  • NAMESPACE - Ruang nama untuk metrik.

  • METRIC_NAME - 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_PERIODS - Jumlah periode untuk mengevaluasi metrik.

  • COMPARISON - Operator perbandingan.

  • THRESHOLD - Ambang batas.

Amazon CloudWatch CLI menampilkan kesalahan pada stderr.

Contoh

Contoh permintaan

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

Unduh

Tindakan terkait

Perintah-perintah terkait