Download PDF
Download page アクションの抑制 API.
アクションの抑制 API
このページでは、イベントに対応するポリシーによってアクションおよびアラートの自動トリガーを一時的に停止できるアクションの抑制 API メソッドについて説明します。API は、メンテナンスアクティビティの実行時、またはコンポーネントのトラブルシューティング時に役立ちます。
注
JSON ペイロードの構文検証は、アクションの抑制を作成する際に実行されます。
新しいアクションの抑制を作成する
指定された JSON ペイロードを使用して新しいアクションの抑制を作成します。「プロパティの詳細」を参照してください。
リソースURL
POST <controller_url>/controller/alerting/rest/v1/applications/<application_id>/action-suppressions
要求/応答の形式
JSON
例
この例では、アプリケーション内の特定の正常性ルールに影響を与えるアクションの抑制を作成します。「例のダウンロード」を参照してください。
{
"id": 9,
"name": "TestAS",
"disableAgentReporting": false,
"suppressionScheduleType": "ONE_TIME",
"timezone": "Asia/Kolkata",
"startTime": "2020-08-19T11:43:00",
"endTime": "2020-08-19T12:43:00",
"recurringSchedule": null,
"affects": {
"affectedInfoType": "APPLICATION"
},
"healthRuleScope": null
}
{
"id": 9,
"name": "TestAS",
"disableAgentReporting": false,
"suppressionScheduleType": "ONE_TIME",
"timezone": "Asia/Kolkata",
"startTime": "2020-08-19T11:43:00",
"endTime": "2020-08-19T12:43:00",
"recurringSchedule": null,
"affects": {
"affectedInfoType": "APPLICATION"
},
"healthRuleScope": null
}
特定のアプリケーションに対して構成されたアクションの抑制のリストの取得
特定のアプリケーションに構成されているすべてのアクションの抑制を返します。必須フィールドは、アクションの抑制 ID と名前です。設定されたアクションの抑制の詳細(timezone
、startTime
、endTime
、recurringSchedule
など)が返されます。「プロパティの詳細」を参照してください。
リソースURL
GET <controller_url>/controller/alerting/rest/v1/applications/<application_id>/action-suppressions
応答形式
JSON
応答の例
[
{
"id": 11,
"name": "TestAS1",
"timezone": "Asia/Kolkata",
"startTime": "2020-08-19T12:06:00",
"endTime": "2020-08-19T13:06:00"
}
{
"id": 12,
"name": "TestAS2",
"timezone": "Asia/Kolkata",
"startTime": "2020-08-19T12:27:00",
"endTime": "2020-08-19T13:27:00"
}
{
"id": 13,
"name": "TestAS3",
"timezone": "Asia/Kolkata",
"startTime": "2020-08-19T12:08:00",
"endTime": "2020-08-19T13:08:00"
}
]
アクションの抑制の詳細の取得
指定されたアクション抑制 ID のアクション抑制の JSON 表現を返します。「プロパティの詳細」を参照してください。
リソースURL
GET <controller_url>/controller/alerting/rest/v1/applications/<application_id>/action-suppressions/{action-suppression-id}
応答形式
JSON
応答の例
{
"id": 9,
"name": "TestAS",
"disableAgentReporting": false,
"suppressionScheduleType": "ONE_TIME",
"timezone": "Asia/Kolkata",
"startTime": "2020-08-19T11:43:00",
"endTime": "2020-08-19T12:43:00",
"recurringSchedule": null,
"affects": {
"affectedInfoType": "APPLICATION"
},
"healthRuleScope": null
}
アクションの抑制の更新
指定された JSON ペイロードを使用して既存のアクションの抑制を更新します。「プロパティの詳細」を参照してください。
リソースURL
PUT <controller_url>/controller/alerting/rest/v1/applications/<application_id>/action-suppressions/{action-suppression-id}
要求/応答の形式
JSON
例
{
"id": 9,
"name": "TestAS1",
"disableAgentReporting": false,
"suppressionScheduleType": "ONE_TIME",
"timezone": "Asia/Kolkata",
"startTime": "2020-08-19T12:05:00",
"endTime": "2020-08-19T13:05:00",
"recurringSchedule": null,
"affects": {
"affectedInfoType": "APPLICATION"
},
"healthRuleScope": null
}
{
"id": 9,
"name": "TestAS",
"disableAgentReporting": false,
"suppressionScheduleType": "ONE_TIME",
"timezone": "Asia/Kolkata",
"startTime": "2020-08-19T11:43:00",
"endTime": "2020-08-19T12:43:00",
"recurringSchedule": null,
"affects": {
"affectedInfoType": "APPLICATION"
},
"healthRuleScope": null
}
アクションの抑制の削除
指定された ID を使用してアクションの抑制を削除します。「プロパティの詳細」を参照してください。
リソースURL
DELETE <controller_url>/controller/alerting/rest/v1/applications/<application_id>/action-suppressions/{action-suppression-id}
名前によるアクションの抑制の詳細の取得
指定されたアクション抑制名のアクション抑制の JSON 表現を返します。「プロパティの詳細」を参照してください。
リソースURL
GET <controller_url>/controller/alerting/rest/v1/applications/<application_id>/action-suppressions/action-suppression-by-name/?name=<ActionSuppressionName>
<ActionSuppressionName>
を、アクションの抑制に指定した名前に置き換えます。たとえば、ACTION_SUP_15
のようになります。
応答形式
JSON
応答の例
{
"id": 9,
"name": "TestAS1",
"timezone": "Asia/Kolkata",
"startTime": "2020-08-19T12:05:00",
"endTime": "2020-08-19T13:05:00",
"recurringSchedule": null
}
応答コード
コード | 説明 |
---|---|
200 | 正常に取得されました |
201 | 正常に作成されました |
204 | 正常に削除されました |
400 | Bad request |
401 | 未認可 |
403 | Forbidden |
404 | リソースが見つかりません |
409 | すでに存在します |
Property Details
アクションの抑制
アクションの抑制のペイロードの詳細。
プロパティ名 | タイプ | 説明と有効な値 | ||||||
---|---|---|---|---|---|---|---|---|
id | 整数 | これはシステムによって自動生成され、応答で返されます。 これは | ||||||
| string minLength: 1 | アクションの抑制の名前。 | ||||||
disableAgentReporting | boolean デフォルト: | 有効にした場合、範囲内に定義されているエージェントは、指定されたタイムフレーム中にメトリックデータを報告しません。 | ||||||
| ||||||||
suppressionScheduleType | string デフォルト:ONE_TIME | アクションの抑制に使用可能なスケジューリングオプション。 Enums
| ||||||
timezone | string | タイムゾーン ID。デフォルトのタイムゾーンはコントローラのタイムゾーンです。 | ||||||
startTime | string 形式:yyyy-MM-ddTHH:mm:ss | アクションの抑制が開始される時刻。 | ||||||
endTime | string 形式:yyyy-MM-ddTHH:mm:ss | 進行中のアクションの抑制が終了する時刻。suppressionScheduleType が [ONE_TIME] に設定されている場合にのみ startTime を指定します。指定しない場合、アクションの抑制は現在の時刻から 60 分後に終了します。予期される形式は、rfc3339 に準拠する yyyy-MM-ddTHH:mm:ss です。 | ||||||
recurringSchedule | string | アクションの抑制を開始するための定期的なスケジュールの詳細。
| ||||||
| アクションの抑制の影響を受けるエンティティについて説明します。たとえば、アプリケーション、ビジネストランザクション、サーバ、データベースなどです。
| |||||||
healthRuleScope* | アクションの抑制に適用できる正常性ルールの範囲。
|
アクションの抑制のスケジュールタイプ
このプロパティを使用して、1 回限りの、または繰り返し実行されるアクションの抑制をスケジュールします。
プロパティ名 | タイプ | 説明 |
---|---|---|
ActionSuppressionScheduleType | string | Enums
|
1 回限りのアクションの抑制の例
JSON
|
スケジュールを繰り返す頻度の詳細
このプロパティを使用して、定期的にアクションの抑制を呼び出す頻度を定義します。
プロパティ名 | タイプ | 説明 |
---|---|---|
scheduleFrequency * | string | アクションの抑制を呼び出す頻度について説明します。 Enums
|
日次でスケジュールされている繰り返しアクションの抑制の例
JSON
|
日次スケジュール:設定の詳細
次のプロパティを使用して、日次でスケジュールされるアクションの抑制の詳細を設定します。
プロパティ名 | タイプ | 説明 |
---|---|---|
scheduleFrequency * | string | アクションの抑制が毎日呼び出されます。 列挙体
|
startTime* | Time string パターン:^([01]\d|2[0-3]):([0-5]\d)$ | アクションの抑制が開始される時刻。 時刻は 24 時間形式です。 |
endTime* | Time string パターン:^([01]\d|2[0-3]):([0-5]\d)$ | 進行中のアクションの抑制が終了する時刻。 時刻は 24 時間形式です。 |
例
JSON
|
週次スケジュール:設定の詳細
次のプロパティを使用して、週次でスケジュールされるアクションの抑制の詳細を設定します。
プロパティ名 | タイプ | 説明 | ||||||
---|---|---|---|---|---|---|---|---|
scheduleFrequency * | string | アクションの抑制が特定の曜日に呼び出されます。 列挙体
| ||||||
days * | string minItems:1 maxItems:7 | アクションを抑制する曜日。
| ||||||
startTime* | Time string パターン: | アクションの抑制が開始される時刻。 時刻は 24 時間形式です。 | ||||||
endTime* | Time string パターン: | 進行中のアクションの抑制が終了する時刻。 時刻は 24 時間形式です。 | ||||||
例
JSON
|
月次の特定の日付にスケジュール:設定の詳細
次のプロパティを使用して、月次の特定の日付にスケジュールされるアクションの抑制の詳細を設定します。
プロパティ名 | タイプ | 説明 |
---|---|---|
scheduleFrequency * | string | アクションの抑制が毎月特定の日に呼び出されます。 列挙体
|
startDate* | string パターン: | 当該月でアクションを抑制する最初の日。 |
startTime* | Time string パターン: | アクションの抑制が開始される時刻。 時刻は 24 時間形式です。 |
endDate * | string パターン: | 当該月でアクションを抑制する最後の日。 |
endTime* | Time string パターン: | 進行中のアクションの抑制が終了する時刻。 時刻は 24 時間形式です。 |
例
JSON
|
月次の特定の曜日にスケジュール:設定の詳細
次のプロパティを使用して、月次の特定の日付にスケジュールされるアクションの抑制の詳細を設定します。
プロパティ名 | タイプ | 説明 | ||||||
---|---|---|---|---|---|---|---|---|
scheduleFrequency * | string | アクションの抑制が当該月の特定の曜日に呼び出されます。 列挙体
| ||||||
startTime* | Time string パターン: | アクションの抑制が開始される時刻。 時刻は 24 時間形式です。 | ||||||
endTime* | Time string パターン: | 進行中のアクションの抑制が終了する時刻。 時刻は 24 時間形式です。 | ||||||
days * | string | 当該月でアクションを抑制する曜日。
| ||||||
occurrence * | string | Enums
| ||||||
例
JSON
|
スケジュールの頻度の詳細
このプロパティを使用して、アクションの抑制を呼び出す頻度を定義します。
プロパティ名 | タイプ | 説明 |
---|---|---|
scheduleFrequency * | string | Enums
|
例
JSON
|
発生の詳細
当該月でアクションの抑制が発生する曜日。
プロパティ名 | タイプ | 説明 |
---|---|---|
occurrence | string | Enums
|
例
JSON
|
月次のアクションの抑制:曜日
当該月でアクションを抑制する曜日。
プロパティ名 | タイプ | 説明 |
---|---|---|
DayOfWeek | string | Enums
|
例
JSON
|
アクションを抑制する時刻の詳細
このプロパティを使用して、アクションを抑制する時刻の詳細を定義します。
プロパティ名 | タイプ | 説明 |
---|---|---|
Time | string パターン: | 時刻は 24 時間形式です。 |
例
JSON
|
タイムゾーン(Timezone)
プロパティ名 | タイプ | 説明 |
---|---|---|
Timezone | string | タイムゾーン ID。デフォルトのタイムゾーンはコントローラのタイムゾーンです。 |
例
JSON
|
アクションの抑制の影響を受けるエンティティ
アクションの抑制の影響を受けるエンティティに関する情報。
プロパティ名 | タイプ | 説明と有効な値 |
---|---|---|
| string | Enums
|
例
JSON
|
アクションの抑制の影響を受けるアプリケーションレベルのエンティティ
アプリケーションレベルでエンティティのアクションを抑制するために使用します。
プロパティ名 | タイプ | 説明と有効な値 |
---|---|---|
| string | 列挙体
|
例
JSON
|
アクションの抑制の影響を受けるビジネストランザクション
ビジネストランザクション(BT)レベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 | ||||||
---|---|---|---|---|---|---|---|---|
| string | 列挙体
| ||||||
affectedBusinessTransactions* | アクションの抑制の影響を受けるビジネストランザクションの範囲。
| |||||||
例
JSON
|
影響を受けるビジネストランザクションの範囲
選択した BT タイプについて、BT レベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 |
---|---|---|
businessTransactionScope* | string | Enums
|
すべてのタイプのビジネストランザクション
すべての BT について、BT レベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 |
---|---|---|
businessTransactionScope* | string | 列挙体
|
例
JSON
|
特定のビジネストランザクション
特定の BT についてのみ BT レベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 |
---|---|---|
businessTransactionScope* | string | 列挙体
|
businessTransactions* | 文字列の配列 minItems: 1 | アクションの抑制の影響を受ける特定のビジネストランザクション。次に例を示します。
|
例
JSON
|
特定の階層に関連付けられたビジネストランザクション
特定の階層内の BT についてのみ、BT レベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 |
---|---|---|
businessTransactionScope* | string | 列挙体
|
specificTiers* | 文字列の配列 minItems: 1 | アクションの抑制の影響を受ける特定の階層に関連付けられたビジネストランザクション。次に例を示します。
|
例
JSON
|
パターンに一致するビジネストランザクション
指定されたパターンに一致するプロパティを持つ BT について、BT レベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
businessTransactionScope* | string | Enums
| ||||||||||||
patternMatcher* | EntityMatchingPattern
| |||||||||||||
例
JSON
|
影響を受ける階層またはノードのエンティティ
階層レベルまたはノードレベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 | ||||||
---|---|---|---|---|---|---|---|---|
| string | 列挙体
| ||||||
affectedEntities* | TierNodeEntities
| |||||||
例
JSON
|
影響を受ける階層またはノードのエンティティ
階層レベルまたはノードレベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 |
---|---|---|
tierNodeType* | string | Enums
|
影響を受ける階層レベルのエンティティ
プロパティ名 | タイプ | 説明と有効な値 | ||||||
---|---|---|---|---|---|---|---|---|
tierNodeType* | string | 列挙体
| ||||||
affectedTiers* | AffectedTiers
| |||||||
例
JSON
|
影響を受けるノードレベルのエンティティ
プロパティ名 | タイプ | 説明と有効な値 | ||||||
---|---|---|---|---|---|---|---|---|
tierNodeType* | string | 列挙体
| ||||||
nodeType* | string | Enums
| ||||||
affectedNodes* | AffectedNodes
| |||||||
例
JSON
|
影響を受ける階層範囲
プロパティ名 | タイプ | 説明と有効な値 |
---|---|---|
affectedTierScope* | string | Enums
|
全階層
すべての階層について、階層レベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 |
---|---|---|
affectedTierScope* | string | 列挙体
|
例
JSON
|
特定の階層
特定の階層についてのみ、階層レベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 |
---|---|---|
affectedTierScope* | string | 列挙体
|
tiers* | 文字列の配列 minItems: 1 | |
例
JSON
|
影響を受けるノード
プロパティ名 | タイプ | 説明と有効な値 |
---|---|---|
affectedNodeScope* | string | Enums
|
例
JSON
|
すべてのノード
すべてのノードについて、ノードレベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 |
---|---|---|
affectedNodeScope* | string | 列挙体
|
例
JSON
|
特定のノード(Specific Nodes)
特定のノードについてのみ、ノードレベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 |
---|---|---|
affectedNodeScope* | string | 列挙体
|
nodes* | 文字列の配列 minItems: 1 | アクションの抑制の影響を受けるエンティティと見なされるノードのリスト。次に例を示します。
|
例
JSON
|
特定の階層内のノード
特定の階層内のノードについてのみ、ノードレベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 |
---|---|---|
affectedNodeScope* | string | 列挙体
|
specificTiers* | 文字列の配列 minItems: 1 | |
例
JSON
|
パターンに一致するノード
パターンに一致するプロパティを持つノードについて、ノードレベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
affectedNodeScope* | string | 列挙体
| ||||||||||||
patternMatcher* | EntityMatchingPattern
| |||||||||||||
例
JSON
|
ノードプロパティ変数マッチ機能
指定された環境変数に一致するノードについて、ノードレベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
affectedNodeScope* | string | 列挙体
| ||||||||||||
propVarPairs* |
| |||||||||||||
例
JSON
|
影響を受けるサーバ
サーバレベルでエンティティのアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明と有効な値 | ||||||
---|---|---|---|---|---|---|---|---|
| string | 列挙体
| ||||||
affectedServers* | ApplicationAffectedServers
| |||||||
例
JSON
|
アプリケーション内の特定のサーバ
アプリケーション内の特定のサーバについて、サーバレベルでエンティティのアクションを抑制するには、このプロパティを使用します。
プロパティ名 | タイプ | 説明 |
---|---|---|
serversScope* | string | 列挙体
|
specificServers* | 文字列の配列 minItems: 1 minLength: 1 | アクションの抑制の影響を受けるエンティティと見なされるサーバのリスト。例:
|
例
JSON
|
影響を受けるデータベース
データベースレベルでエンティティのアクションを抑制するには、このプロパティを使用します。
プロパティ名 | タイプ | 説明と有効な値 | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| string | 列挙体
| ||||||||||||
affectedDatabases* | AffectedDatabases
| |||||||||||||
例
JSON
|
影響を受けるデータベースの範囲
データベースレベルでアクションの抑制範囲を定義するには、このプロパティを使用します。
プロパティ名 | タイプ | 説明 | ||||||
---|---|---|---|---|---|---|---|---|
databaseScope* | string |
|
影響を受けるデータベースの範囲:すべてのデータベース
すべてのデータベースのエンティティに対するアクションを抑制するには、このプロパティを使用します。
プロパティ名 | タイプ | 説明 | ||||||
---|---|---|---|---|---|---|---|---|
databaseScope* | string |
|
影響を受けるデータベースの範囲:特定のデータベース
特定のデータベースのエンティティに対するアクションを抑制するには、このプロパティを使用します。
プロパティ名 | タイプ | 説明 | ||||||
---|---|---|---|---|---|---|---|---|
databaseScope* | string |
| ||||||
databases * | 文字列の配列 minItems: 1 | DbServer
| ||||||
例
JSON
|
データベースサーバの詳細
データベースサーバの詳細を定義するには、このプロパティを使用します。
プロパティ名 | タイプ |
---|---|
| string minLength: 1 |
collectorConfigName * | string minLength: 1 |
影響を受けるデータベースタイプ
影響を受けるデータベースの範囲を定義するには、このプロパティを使用します。
プロパティ名 | タイプ | 説明 |
---|---|---|
AffectedDatabaseType | string | Enums
|
正常性ルールの範囲
正常性ルール違反イベントへの応答としてトリガーされるアクションを抑制するには、これを使用します。
プロパティ名 | タイプ | 説明 |
---|---|---|
healthRuleScopeType* | string | HealthRuleScopeType列挙体
|
例
JSON
|
正常性ルールの範囲タイプ
プロパティ名 | タイプ | 説明 |
---|---|---|
healthRuleScope* | string | 列挙体
|
特定の正常性ルール
プロパティ名 | タイプ | 説明 |
---|---|---|
healthRuleScopeType* | string | HealthRuleScopeType列挙体
|
healthRules* | 文字列の配列 minItems: 1 | |
例
JSON
|
アクションの抑制の概要
プロパティ名 | タイプ |
---|---|
id* | 整数 |
| 文字列 minLength: 1 |
エラー応答
プロパティ名 | タイプ |
---|---|
statusCode | 整数 |
| 文字列 |
*This property is required.
例のダウンロード
Appdynamics Action Suppression examples.zip をダウンロードして、スケジュールを設定するのに役立つ一連の例を取得します。
SWAGGER YAML ファイルのダウンロード
Swagger YAML 仕様 action_suppression_openapi.yml をダウンロードします。