本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # mon-describe-alarm-history ## Description 擷取指定警示的歷史記錄。您可以依日期範圍或項目類型來篩選警示。如果您不指定警示名稱，Amazon CloudWatch 會傳回所有警示的歷史記錄。 **注意** Amazon CloudWatch 會將作用中和刪除的警示歷史記錄保留 2 週。 ## 語法 ****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 或 Action
預設：傳回所有類型。
必要：否 | | `--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 或 所提供 PEM 檔案的有效檔案路徑 AWS Identity and Access Management。
預設：使用環境變數 `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` 來指定該值。該區域可用於建立用來呼叫 CloudWatch 的 URL，並且必須是有效的 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 的 URL。您可以使用環境變數 `AWS_CLOUDWATCH_URL` 來設定這個值。這個值可與 `--region` 搭配使用，以建立預期的 URL。此選項會覆寫用於服務呼叫的 URL。
類型：字串
有效值：有效的 HTTP 或 HTTPS URL。
預設：使用 `AWS_CLOUDWATCH_URL` 中指定的值 (如果設定)。 | ## Output 此命令會傳回一個表格，其中包含下列項目： + ALARM - 警示名稱。 + TIMESTAMP - 時間戳記。 + TYPE - 事件的類型，ConfigurationUpdate、StateUpdate 和 Action 其中一個。 + SUMMARY - 人類可閱讀的歷史記錄事件摘要。 + DATA - 事件的詳細資料 (機器可讀取的 JSON 格式)。此欄只出現在 --show-long 檢視中。 Amazon CloudWatch CLI 會在 stderr 上顯示錯誤。 ## 範例 ### 範例請求 此範例說明 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 ``` ## 相關主題 ### 下載 + [設定命令列介面](SetupCLI.md) ### 相關動作 + [DescribeAlarmHistory](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarmHistory.html) ### 相關命令 + [mon-describe-alarms](cli-mon-describe-alarms.md) + [mon-describe-alarms-for-metric](cli-mon-describe-alarms-for-metric.md)