インシデントのリストの取得
get
https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/incidents
指定されたフィルタに基づいてインシデントのリストを返します。デフォルトでは、最も最近作成されたインシデントを先頭に示す、すべてのオープン・インシデントの最初のセットが返されます。
リクエスト
問合せパラメータ
- ageInHoursLessThanOrEqualTo: integer(int32)
指定された日数より新しいインシデントを取得しますデフォルト値:
744
例:24
- includeMemberTargets: boolean
指定されたターゲットのメンバーに関する一致するインシデントを含めますデフォルト値:
true
- limit: integer(int32)
現在のコールで返されるアイテムの数を制限します。アイテムを追加でフェッチするには、レスポンスからのself/previous/nextリンクを使用します。デフォルト値:
50
- page: string
取得するアイテムのセットを特定します。レスポンスのlinksリストのhref要素により、このパラメータのエンコードされた値が提供されます。href要素の値は、それぞれのアイテム・セットをフェッチする場合はそのまま使用する必要があります。デフォルト値:
Base64エンコード値0 つまり、MA==
- severity: array[]
指定された重大度でフィルタします
- sort: string
id、displayId、timeCreated、timeUpdated、statusおよびownerなどの属性で結果をソートします例:
displayId:ASC,timeUpdated:DESC
- targetName: string
特定のターゲット名でフィルタします。
- targetTypeName: string
特定のターゲット・タイプでフィルタします。
この操作にはリクエスト本文はありません。
先頭に戻るレスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
操作成功 - インシデント・リストをフェッチする
ルート・スキーマ: IncidentCollection
インシデント・サマリーのリスト
すべてに一致
ソースの表示
- object ListRspns
一般リスト・レスポンス・ラッパー
- object IncidentCollection-allOf[1]
ネストされたスキーマ: ListRspns
型:
object
一般リスト・レスポンス・ラッパー
ソースの表示
-
count(必須): integer (int32)
戻される行の数例:
1
-
links: object links
読取り専用:
true
ページ分割されたリソースへのURLリンク。
ネストされたスキーマ: links
型:
object
読取り専用:
true
ページ分割されたリソースへのURLリンク。
ソースの表示
-
next: object Link
リンクを表します(self、previous、nextのいずれか)
-
previous: object Link
リンクを表します(self、previous、nextのいずれか)
-
self(必須): object Link
リンクを表します(self、previous、nextのいずれか)
例:
{
"self":{
"href":"/em/api/incidents?page=MQ%3D%3D&limit=50"
},
"next":{
"href":"/em/api/incidents?page=Mg%3D%3D&limit=50"
},
"previous":{
"href":"/em/api/incidents?page=MA%3D%3D&limit=50"
}
}
ネストされたスキーマ: Link
型:
object
リンクを表します(self、previous、nextのいずれか)
ソースの表示
-
href: string
リンクのためのURL例:
/em/api/<resources>?page=b2Zmc2V0OjA&limit=0
ネストされたスキーマ: IncidentSummary
型:
object
インシデントのサマリー
ソースの表示
-
ageInHours: integer (int64)
読取り専用:
true
インシデント経過期間例:855
-
canBeManuallyClosed: boolean
デフォルト値:
false
ユーザーがそのインシデントをクリアできるかどうか。例:true
-
displayId(必須): integer (int64)
読取り専用:
true
インシデントの表示ID例:35
-
escalationLevel: object EscalationLevel
エスカレーション・レベルの詳細
-
id(必須): string (raw)
読取り専用:
true
インシデントのID例:C4E214A1172A2F19E053860E4B645AC7
-
isDiagnosticIncident: boolean
デフォルト値:
false
自動診断リポジトリ(ADR)のインシデントかどうか。例:false
-
isEscalated: boolean
そのインシデントがエスカレートされるかどうか。例:
true
-
isOpen(必須): boolean
そのインシデントがオープンされているかどうか。例:
true
-
links: object links
読取り専用:
true
リソースの詳細に含まれているURLリンク。 -
message(必須): string
インシデントのメッセージ例:
CPU使用率は10.821%で、警告(5)またはクリティカル(10)のしきい値を超えています
-
nonTargetEntities: array nonTargetEntities
最小アイテム数:
0
一意のアイテムが必要:true
このインシデントの影響を受けるターゲット以外のエンティティ(ジョブなど) -
owner: string
インシデントの現在の所有者例:
SYSMAN
-
priority: object Priority
優先度の詳細
-
severity(必須): string
読取り専用:
true
指定可能な値:[ "FATAL", "CRITICAL", "WARNING", "MINOR_WARNING", "CLEAR" ]
サポートされている重大度リスト例:CRITICAL
-
status(必須): string
インシデントの現在のステータス例:
new
-
suppressionStatus: object SuppressionStatus
抑止ステータスの詳細
-
targets: array targets
最小アイテム数:
0
一意のアイテムが必要:true
このインシデントの影響を受けるターゲット -
ticket: object TicketSummary
読取り専用:
true
チケットの詳細 -
timeCreated(required): string (日時)
読取り専用:
true
インシデントが作成された時間例:2021-06-16T12:17:56.000Z
-
timeUpdated(required): string (日時)
読取り専用:
true
インシデントが更新された時間例:2021-07-22T06:25:42.000Z
ネストされたスキーマ: EscalationLevel
型:
object
エスカレーション・レベルの詳細
ソースの表示
-
displayName: string
エスカレーション・レベルの表示名例:
None
-
name(必須): string
読取り専用:
true
指定可能な値:[ "NONE", "L1", "L2", "L3", "L4", "L5" ]
サポートされているエスカレーション・レベル・リスト例:NONE
ネストされたスキーマ: links
型:
object
読取り専用:
true
リソースの詳細に含まれているURLリンク。
ソースの表示
-
self(必須): object Link
リンクを表します(self、previous、nextのいずれか)
例:
{
"self":{
"href":"/em/api/incidents/C4E214A1172A2F19E053860E4B645AC7"
}
}
ネストされたスキーマ: nonTargetEntities
型:
array
最小アイテム数:
0
一意のアイテムが必要:
true
このインシデントの影響を受けるターゲット以外のエンティティ(ジョブなど)
ソースの表示
- 配列: object SourceEntity
ソース・エンティティの詳細
ネストされたスキーマ: Priority
型:
object
優先度の詳細
ソースの表示
-
displayName: string
読取り専用:
true
優先度の表示ラベル例:None
-
name(必須): string
優先度の内部名例:
PRIORITY_NONE
ネストされたスキーマ: SuppressionStatus
型:
object
抑止ステータスの詳細
ソースの表示
-
isSuppressed(必須): boolean
デフォルト値:
false
抑止が有効になっているかどうか。 -
suppressUntil: string
指定可能な値:
[ "MANUALLY_UNSUPPRESSED", "INCIDENT_CLOSES", "INCIDENT_SEVERITY_CHANGES", "AFTER_A_DAY", "AFTER_A_WEEK", "AFTER_DATE" ]
抑止タイプ -
timeToEndSuppression: string (date-time)
抑止終了時間
ネストされたスキーマ: targets
型:
array
最小アイテム数:
0
一意のアイテムが必要:
true
このインシデントの影響を受けるターゲット
ソースの表示
- 配列: object schema
ターゲットの詳細
ネストされたスキーマ: TicketSummary
型:
object
読取り専用:
true
チケットの詳細
ソースの表示
-
id: string
読取り専用:
true
チケットのID例:51d62b6cd1384ba89aeddfa647ea1380
-
status: string
チケットのステータス例:
Triggered
-
type: string
チケットのタイプ例:
TICKET
-
url: string
チケットのURL例:
https://api.pagerduty.com/incidents?incident_key=F746283FHDKC
ネストされたスキーマ: SourceEntity
型:
object
ソース・エンティティの詳細
ソースの表示
-
id(必須): string (raw)
エンティティのID例:
317C6AD6C69832D0ADDA279BEB7B7F32
-
name(必須): string
エンティティの名前例:
bkupjob-123456
-
subTypeDisplayName: string
エンティティ・タイプのサブ・タイプの表示名例:
Database backup job
-
subTypeName: string
エンティティ・タイプのサブタイプ例:
DBBackupJob
-
typeDisplayName: string
エンティティ・タイプの表示名例:
Job
-
typeName(必須): string
エンティティのタイプ例:
JOB
ネストされたスキーマ: schema
型:
object
ターゲットの詳細
ソースの表示
-
targetName: string
ターゲットの名前例:
sales_db1
-
targetType: string
ターゲットのタイプ例:
oracle_database
400レスポンス
不正なリクエスト
ルート・スキーマ: ErrorResponse
型:
object
エラー・レスポンス
ソースの表示
-
code(必須): string
プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
-
message(必須): string
判読可能なエラー文字列
401レスポンス
認証に失敗しました
ルート・スキーマ: ErrorResponse
型:
object
エラー・レスポンス
ソースの表示
-
code(必須): string
プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
-
message(必須): string
判読可能なエラー文字列
404レスポンス
見つかりません
ルート・スキーマ: ErrorResponse
型:
object
エラー・レスポンス
ソースの表示
-
code(必須): string
プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
-
message(必須): string
判読可能なエラー文字列
500レスポンス
内部サーバー・エラー
ルート・スキーマ: ErrorResponse
型:
object
エラー・レスポンス
ソースの表示
-
code(必須): string
プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
-
message(必須): string
判読可能なエラー文字列
503レスポンス
サービスを使用できません
ルート・スキーマ: ErrorResponse
型:
object
エラー・レスポンス
ソースの表示
-
code(必須): string
プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
-
message(必須): string
判読可能なエラー文字列