本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
mon-describe-alarms
描述
取得指定警示的相關資訊。如果您不指定警示名稱,此命令會傳回所有警示的相關資訊。您可以只使用警示名稱字首、警示狀態或動作字首來擷取警示。
語法
mon-describe-alarms
[AlarmNames [
AlarmNames
...]] [--action-prefix value
] [--alarm-name-prefix value
]
[--state-value value
] [Common Options]
選項
名稱 | 描述 |
---|---|
|
警示的名稱。您也可以使用 類型:引數 有效值:現有的警示名稱,否則不會傳回任何回應。 預設:無,在預設情況下會顯示所有警示。 必要:否 |
|
動作名稱的字首。 類型:引數 有效值:現有動作名稱的字首 (ARN 格式)。 預設:無,在預設情況下會顯示第一個動作。 必要:否 |
|
警示名稱的字首。 類型:引數 有效值:現有警示名稱的字首。 預設:無 必要:否 |
|
警示的狀態。 類型:列舉 有效值:OK、ALARM 或 INSUFFICIENT_DATA 預設:所有警示狀態。 必要:否 |
常用選項
名稱 | 描述 |
---|---|
|
包含您 AWS 認證的檔案位置。您可以使用環境變數 類型:字串 有效值:檔案的有效路徑,包含存取金鑰 ID 和私密存取金鑰。 預設:使用環境變數 |
|
用於簽署請求的 EC2 憑證檔案位置。您可使用環境變數 類型:字串 有效值:由 Amazon EC2 或 AWS Identity and Access Management提供的 PEM 檔案的有效檔案路徑。 預設:使用環境變數 |
|
連線逾時值 (以秒為單位)。 類型:整數 有效值:任何正數。 預設:30 |
|
顯示分隔符號 (長) 結果時使用的分隔符號。 類型:字串 有效值:任何字串。 預設:逗號 (,) |
|
如果您要顯示表格式或分隔式結果,請包含欄標題。如果顯示 XML 結果,請從服務請求傳回 HTTP 標題 (如適用)。 類型:標記 有效值:如果存在,則顯示標題。 預設: |
|
將用於簽署請求的存取金鑰 ID,與私密金鑰搭配使用。此參數必須與私密金鑰搭配使用,否則會忽略該選項。所有要求都 CloudWatch 必須簽署,否則請求將被拒絕。 類型:字串 有效值:有效的存取金鑰 ID。 預設:無 |
|
將用於簽署請求的私有金鑰。使用公有/私有金鑰會導致 CLI 使用 SOAP。使用公有憑證和私有金鑰簽署請求。此參數必須與 類型:字串 有效值:有效 ASN.1 私有金鑰的路徑。 預設:無 |
|
該區域請求被導向。您可使用環境變數 類型:字串 有效值:任何 AWS 區域,例如 us-east-1。 預設:us-east-1,除非設定了 |
|
將用於簽署請求的私密存取金鑰,與存取金鑰 ID 搭配使用。此參數必須與 類型:字串 有效值:您的存取金鑰 ID。 預設:無 |
|
使用 (nil) 作為預留位置顯示空欄位,表示未請求此資料。 類型:標記 有效值:無 預設:預設不會顯示空欄位。 |
|
顯示 CLI 用來呼叫 AWS的 URL。 類型:標記 有效值:無 預設:false |
|
指定結果的顯示方式:在表格中、分隔符號 (長)、XML 或無輸出 (靜音)。 類型:標記 有效值:無 預設: |
|
用來聯絡的網址 CloudWatch。您可以使用環境變數 類型:字串 有效值:有效的 HTTP 或 HTTPS URL。 預設:使用 |
輸出
此命令會傳回一個表格,其中包含下列項目:
-
ALARM - 警示名稱。
-
DESCRIPTION - 警示說明。此欄只出現在 --show-long 檢視中。
-
STATE - 警示狀態。
-
STATE_REASON - 人類可讀取的狀態原因。此欄只出現在 --show-long 檢視中。
-
STATE_REASON_DATA - 機器可讀取的狀態原因 (JSON 格式)。此欄只出現在 --show-long 檢視中。
-
ENABLED - 啟用或停用動作。此欄只出現在 --show-long 檢視中。
-
OK_ACTIONS - 在 OK 狀態上執行的動作。此欄只出現在 --show-long 檢視中。
-
ALARM_ACTIONS - 在 ALARM (警示) 狀態上執行的動作。
-
INSUFFICIENT_DATA_ACTIONS - 在 INSUFFICIENT_DATA 狀態上執行的動作。此欄只出現在 --show-long 檢視中。
-
NAMESPACE - 指標的命名空間。
-
METRIC_NAME - 指標的名稱。
-
DIMENSIONS - 指標維度。此欄只出現在 --show-long 檢視中。
-
PERIOD - 期間。
-
統計-統計值 (平均值、最小值、最大值、 SampleCount總和)。
-
EXTENDEDSTATISTIC - 百分位數統計。
-
UNIT - 單位。此欄只出現在 --show-long 檢視中。
-
EVAL_PERIODS - 評估指標的期間數。
-
COMPARISON - 比較運算子。
-
THRESHOLD - 閾值。
Amazon CloudWatch CLI 在標準錯誤上顯示錯誤。
範例
範例請求
此範例說明名稱開頭為 my-alarm 的所有警示。
mon-describe-alarms --alarm-name-prefix my-alarm --headers
這是此命令的輸出範例。
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