mon-put-metric-alarm
説明
アラームを作成または更新し、指定された CloudWatch メトリクスにそのアラームを関連付けます。また、このコマンドを使用して、1 つのアラームに 1 つ以上の Amazon Simple Notification Service (Amazon SNS) リソースを関連付けることもできます。
この操作でアラームを作成するとすぐ、アラームの状態が INSUFFICIENT_DATA になります。アラームは評価され、その StateValue は適切に設定されます。その後、StateValue と関連付けられたアクションが実行されます。
注記
既存のアラームを更新しても、StateValue は変更されません。
構文
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]
オプション
| 名前 | 説明 |
|---|---|
|
|
更新または作成するアラームの名前。名前は AWS アカウント内で一意でなければなりません。この値は タイプ: 引数 有効値: UTF-8 文字列。 デフォルト: N/A 必須 : はい |
|
|
アラームの状態が変わったときにアクションを実行するかどうかを指定します。 タイプ: ブール値 有効値: True または False デフォルト: True 必須: いいえ |
|
|
このアラームが ALARM 以外の状態から ALARM 状態に移行したときに実行するアクション (最大 5 個)。各アクションは Amazon リソースネーム (ARN) として指定されます。アラームアクションを使用して、Amazon SNS トピックへの公開、Amazon EC2 Auto Scaling ポリシーのアクティブ化、または Amazon EC2 インスタンスの停止、終了、復旧を行うことができます。 注記AWS Identity and Access Management (IAM) アカウントを使用してアラームを作成または変更する場合、次の Amazon EC2 の許可が必要です。
Amazon CloudWatch に対する読み取り/書き込み権限は持っているが、Amazon EC2 に対する権限を持っていない場合でも、アラームを作成できますが、停止または終了アクションは Amazon EC2 インスタンスでは実行されません。ただし、関連付けられている Amazon EC2 API の使用許可が後で付与される場合、以前に作成したアラームアクションは実行されるようになります。IAM のアクセス許可の詳細については、IAM ユーザーガイドの「アクセス許可とポリシー」を参照してください。 IAM ロール (Amazon EC2 インスタンスプロファイルなど) を使用している場合、アラームのアクションを使用してインスタンスを停止または終了することはできません。ただし、アラームの状態を確認して、Amazon SNS 通知や Amazon EC2 Auto Scaling ポリシーなど、その他のアクションを実行することはできます。 AWS Security Token Service (AWS STS) で付与された一時的なセキュリティ認証情報を使用している場合、アラームのアクションを使用して Amazon EC2 インスタンスを停止または終了することはできません。 タイプ: 文字列 有効な値: Amazon SNS トピックの ARN、Auto Scaling ポリシー、または Amazon EC2 インスタンスを停止、終了、回復するための ARN。 デフォルト: N/A 必須: いいえ |
|
|
アラームの説明。 タイプ: 文字列 有効値: 文字長が 1 から 255 の Unicode 文字列 デフォルト: N/A 必須: いいえ |
|
|
データポイントとしきい値の比較に使用する比較演算子。 タイプ: 列挙法 有効値: GreaterThanOrEqualToThreshold、GreaterThanThreshold、LessThanThreshold、または LessThanOrEqualToThreshold のいずれか デフォルト: N/A 必須 : はい |
|
|
作成するアラームに関連して作成するメトリクスのディメンション。ディメンションは 2 つの方法で指定でき、形式を組み合わせて、あるいは互換的に使用することができます。
型: マップ 有効値: name=value 形式の文字列。ここで、key はディメンション名、value はディメンションの値です。ディメンション名と値は、文字長が 1 から 250 の ANSI 文字列である必要があります。最大 10 ディメンションが許可されています。 デフォルト: N/A 必須: いいえ |
|
|
アラームのステータスを決定するためにメトリクスの値としきい値を比較する連続した期間の数。 型: 整数 有効値: 0 より大きい数値 デフォルト: N/A 必須 : はい |
|
|
アラームを設置するメトリクスの名前。 タイプ: 引数 有効値: 文字長が 1 から 250 の ANSI 文字列 デフォルト: N/A 必須 : はい |
|
|
アラームを設置するメトリクスの名前空間。名前空間の詳細については、「AWS の名前空間」を参照してください。 タイプ: 文字列 有効値: 文字長が 1 から 250 の ANSI 文字列 デフォルト: N/A 必須 : はい |
|
|
このアラームが OK 以外の状態から OK 状態に移行したときに実行するアクション (最大 5 個)。各アクションは Amazon リソースネーム (ARN) として指定されます。 タイプ: 文字列 有効値: 有効な ARN 識別子 デフォルト: N/A 必須: いいえ |
|
|
アラームを設置するメトリクスの期間 (秒単位)。 タイプ: 引数 有効値: 秒数、60 の倍数。 デフォルト: N/A 必須 : はい |
|
|
アラームを設置するメトリクスの統計。 タイプ: 列挙法 有効値: SampleCount、Average、Sum、Minimum、または Maximum デフォルト: N/A 必須: --statistic または --extendedstatistic のどちらかを指定する必要があります。 |
|
|
アラームを設置するメトリクスのパーセンタイル統計。 タイプ: 文字列 有効な値: 小数点以下 2 桁までの任意のパーセンタイル (p95.45 など)。 デフォルト: N/A 必須: --statistic または --extendedstatistic のどちらかを指定する必要があります。 |
|
|
アラームの状態を決定するためにデータポイントと比較するしきい値。 型: 倍精度浮動小数点数 有効値: 倍精度浮動小数点数。これらの値はすべて、1E-130 から 1E130 の間の数値である必要があります。 デフォルト: N/A 必須 : はい |
|
|
アラームを設置するメトリクスの単位。 タイプ: 列挙法 有効な値: 以下のいずれかです。
デフォルト: N/A 必須: いいえ |
|
|
このアラームが INSUFFICIENT_DATA 以外の状態から INSUFFICIENT_DATA 状態に移行したときに実行するアクション (最大 5 個)。各アクションは Amazon リソースネーム (ARN) として指定されます。 タイプ: 文字列 有効値: 有効な ARN 識別子 デフォルト: N/A 必須: いいえ |
一般的なオプション
| 名前 | 説明 |
|---|---|
|
|
AWS 認証情報を含むファイルの場所。環境変数 タイプ: 文字列 有効な値: アクセスキー ID とシークレットアクセスキーを含むファイルへの有効なパス。 デフォルト: 設定されている場合は、環境変数 |
|
|
リクエストに署名するための EC2 証明書ファイルの場所。環境変数 タイプ: 文字列 有効な値: Amazon EC2 または によって提供される PEM ファイルへの有効なファイルパスAWS Identity and Access Management デフォルト: 設定されている場合は、環境変数 |
|
|
接続タイムアウト値 (秒)。 型: 整数 有効な値: 任意の正の整数。 デフォルト: 30 |
|
|
長い結果を区切って表示する際に使用する区切り記号。 タイプ: 文字列 有効な値: 任意の文字列。 デフォルト: コンマ（,） |
|
|
表形式の結果または区切られた結果を表示する場合に、列ヘッダーを含めます。XML 形式の結果を表示する場合に、サービスリクエストから HTTP ヘッダーを返します (該当する場合)。 タイプ: フラグ 有効な値: 存在する場合は、ヘッダーを表示します。 デフォルト: |
|
|
リクエストの署名で、シークレットキーと組み合わせて使用するアクセスキー ID。これは、––secret-key と組み合わせて使用する必要があります。単独で使用すると、このオプションは無視されます。CloudWatch へのすべてのリクエストには署名が必要です。署名がないと、リクエストは拒否されます。 タイプ: 文字列 有効な値: 有効なアクセスキー ID。 デフォルト: なし |
|
|
リクエストに署名するために使用されるプライベートキー。パブリック/プライベートキーを使用すると、CLI が SOAP を使用します。リクエストは、パブリック証明書とプライベートキーを使用して署名されます。このパラメータは、 タイプ: 文字列 有効な値: 有効な ASN.1 プライベートキーへのパス。 デフォルト: なし |
|
|
リクエストの送信先のリージョン。環境変数 タイプ: 文字列 有効な値: 任意の AWS リージョン (例: us-east-1) デフォルト: 環境変数 |
|
|
リクエストの署名で、アクセスキー ID と組み合わせて使用するシークレットアクセスキー。このパラメータは、 タイプ: 文字列 有効な値: アクセスキー ID デフォルト: なし |
|
|
プレースホルダーとして (nil) を使用して空のフィールドを表示し、このデータがリクエストされなかったことを示します。 タイプ: フラグ 有効な値: なし デフォルト: デフォルトでは、空のフィールドは表示されません。 |
|
|
CLI が の呼び出しに使用する URL を表示しますAWS タイプ: フラグ 有効な値: なし デフォルト: False |
|
|
結果の表示形式として、表形式、区切り形式 (長い)、XML 形式、または出力なし (非表示) を指定します。 タイプ: フラグ 有効な値: なし デフォルト: |
|
|
CloudWatch への接続に使用する URL。環境変数 タイプ: 文字列 有効な値:有効な HTTP または HTTPS URL。 デフォルト: 設定されている場合は、 |
出力
このコマンドで、指定したメトリクスに関連付けられるアラームを作成または更新します。
Amazon CloudWatch CLI は、stderr でエラーを表示します。
例
リクエストの例
次の例で作成するアラームでは、EC2 インスタンスの CPU 使用率が 1 分単位の期間を 3 つ連続して 90% を超えたときに、トピックにメッセージを発行します。
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
関連トピック
ダウンロード
関連アクション
関連コマンド
