mon-describe-alarm-history - Amazon CloudWatch

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

mon-describe-alarm-history

描述

擷取指定警示的歷史記錄。您可以依日期範圍或項目類型來篩選警示。如果您未指定警示名稱,Amazon 會 CloudWatch 傳回所有警示的歷史記錄。

注意

Amazon CloudWatch 保留活動和已刪除警報的歷史記錄兩週。

語法

mon-describe-alarm-history [AlarmNames [AlarmNames ...]] [--end-date value] [--history-item-type value] [--start-date value] [Common Options]

選項

名稱 描述

AlarmName AlarmNames

警示的名稱,以空格分隔。如果您不指定警示名稱,此命令會傳回所有警示的歷史記錄。您也可以使用 --alarm-name 設定此值。

類型:引數

有效值:長度為 1 到 255 個字元的任何字串。

預設:無

必要:否

--end-date VALUE

歷史記錄的日期範圍結尾。

類型:日期

有效值:YYYY-MM-DD 格式的日期。

預設:當前日期。

必要:否

--history-item-type VALUE

要擷取的日誌項目類型。在預設情況下會傳回所有類型。

類型:列舉

有效值: ConfigurationUpdate StateUpdate、或動作

預設:傳回所有類型。

必要:否

--start-date VALUE

歷史記錄的日期範圍開頭。在預設情況下會延伸到所有可用的歷史記錄。

類型:日期

有效值:YYYY-MM-DD 格式的日期。

預設:所有可用的歷史記錄。

必要:否

常用選項

名稱 描述

--aws-credential-file VALUE

包含您 AWS 認證的檔案位置。您可以使用環境變數 AWS_CREDENTIAL_FILE 來設定這個值。如果您定義環境變數或提供憑證檔案的路徑,則檔案必須存在或請求失敗。所有 CloudWatch 請求都必須使用您的訪問密鑰 ID 和秘密訪問密鑰進行簽名。

類型:字串

有效值:檔案的有效路徑,包含存取金鑰 ID 和私密存取金鑰。

預設:使用環境變數 AWS_CREDENTIAL_FILE (如果設定)。

-C, --ec2-cert-file-path VALUE

用於簽署請求的 EC2 憑證檔案位置。您可使用環境變數 EC2_CERT 來指定這個值。

類型:字串

有效值:由 Amazon EC2 或 AWS Identity and Access Management提供的 PEM 檔案的有效檔案路徑。

預設:使用環境變數 EC2_CERT (如果設定)。

--connection-timeout VALUE

連線逾時值 (以秒為單位)。

類型:整數

有效值:任何正數。

預設:30

--delimiter VALUE

顯示分隔符號 (長) 結果時使用的分隔符號。

類型:字串

有效值:任何字串。

預設:逗號 (,)

--headers

如果您要顯示表格式或分隔式結果,請包含欄標題。如果顯示 XML 結果,請從服務請求傳回 HTTP 標題 (如適用)。

類型:標記

有效值:如果存在,則顯示標題。

預設:--headers 選項預設為關閉。

-I, --access-key-id VALUE

將用於簽署請求的存取金鑰 ID,與私密金鑰搭配使用。此參數必須與私密金鑰搭配使用,否則會忽略該選項。所有要求都 CloudWatch 必須簽署,否則請求將被拒絕。

類型:字串

有效值:有效的存取金鑰 ID。

預設:無

-K, --ec2-private-key-file-path VALUE

將用於簽署請求的私有金鑰。使用公有/私有金鑰會導致 CLI 使用 SOAP。使用公有憑證和私有金鑰簽署請求。此參數必須與 EC2_CERT 搭配使用,否則會忽略該值。如果已設定環境變數的值 EC2_PRIVATE_KEY 且未指定此選項,則將使用該值。如果環境變數,則會忽略此選項。AWS_CREDENTIAL_FILE已設定,或--aws-credentials-file被使用。所有要求都 CloudWatch 必須簽署,否則請求將被拒絕。

類型:字串

有效值:有效 ASN.1 私有金鑰的路徑。

預設:無

--region VALUE

該區域請求被導向。您可使用環境變數 EC2_REGION 來指定該值。該區域用於建立用於呼叫的 URL CloudWatch,且必須是有效的 Amazon Web Services (AWS) 區域。

類型:字串

有效值:任何 AWS 區域,例如 us-east-1。

預設:us-east-1,除非設定了 EC2_REGION 環境變數。

S, --secret-key VALUE

將用於簽署請求的私密存取金鑰,與存取金鑰 ID 搭配使用。此參數必須與 --access-key-id 搭配使用,否則會忽略該選項。

類型:字串

有效值:您的存取金鑰 ID。

預設:無

--show-empty-fields

使用 (nil) 作為預留位置顯示空欄位,表示未請求此資料。

類型:標記

有效值:無

預設:預設不會顯示空欄位。

--show-request

顯示 CLI 用來呼叫 AWS的 URL。

類型:標記

有效值:無

預設:false

--show-table, --show-long, --show-xml, --quiet

指定結果的顯示方式:在表格中、分隔符號 (長)、XML 或無輸出 (靜音)。--show-table 顯示以固定欄寬形式顯示資料子集;--show-long 顯示以字元分隔的所有傳回的值;--show-xml 是從服務傳回的原始值;和 --quiet 會抑制所有標準輸出。所有選項是互斥的,且具有優先順序 --show-table--show-long--show-xml--quiet

類型:標記

有效值:無

預設:--show-table

-U, --url VALUE

用來聯絡的網址 CloudWatch。您可以使用環境變數 AWS_CLOUDWATCH_URL 來設定這個值。這個值可與 --region 搭配使用,以建立預期的 URL。此選項會覆寫用於服務呼叫的 URL。

類型:字串

有效值:有效的 HTTP 或 HTTPS URL。

預設:使用 AWS_CLOUDWATCH_URL 中指定的值 (如果設定)。

輸出

此命令會傳回一個表格,其中包含下列項目:

  • ALARM - 警示名稱。

  • TIMESTAMP - 時間戳記。

  • 類型-事件的類型、其中一 ConfigurationUpdate個 StateUpdate 和動作。

  • SUMMARY - 人類可閱讀的歷史記錄事件摘要。

  • DATA - 事件的詳細資料 (機器可讀取的 JSON 格式)。此欄只出現在 --show-long 檢視中。

Amazon CloudWatch CLI 在標準錯誤上顯示錯誤。

範例

範例請求

此範例說明 my-alarm 警示的所有歷史記錄項目。

mon-describe-alarm-history--alarm-name my-alarm --headers

這是此命令的輸出範例。

ALARM TIMESTAMP TYPE SUMMARY my-alarm 2013-05-07T18:46:16.121Z Action Published a notification to arn:aws:sns:... my-alarm 2013-05-07T18:46:16.118Z StateUpdate Alarm updated from INSUFFICIENT_DATA to OK my-alarm 2013-05-07T18:46:07.362Z ConfigurationUpdate Alarm "my-alarm" created

相關主題

下載

相關動作

相關命令