--- sourceDocument: オーストラリア API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference Release : - australia ft:locale : - ja-JP ft:publication_title : - オーストラリア API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # アラーム管理オープン API # アラーム管理オープン API {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：55分 アラーム管理オープン API は、イベント \[em_event\] テーブルとアラート \[em_alert\] テーブルからデータを作成、更新、および取得するためのエンドポイントを提供します。 Telecommunications Alarm Management Open API (sn_ind_tmf642) は、TM Forum Open API 仕様の ServiceNow® 実装です。この API は、 [TMF642 Alarm Management API ユーザーガイド v5.0.0](https://www.tmforum.org/resources/specifications/tmf642-alarm-management-api-user-guide-v5-0-0/) (2023 年 9 月) に基づいています。 呼び出し元ユーザーは `sn_ind_tmf642.alarm_mgmt_integration` エンドポイントにアクセスする必要があります。 この API は、 `sn_ind_tmf642` 名前空間内で提供されます。 TM Forum Open API 仕様では、受信するすべての受信要求に対して同期応答が必要です。ペイロードをシステムに転送する前に、ソース運用サポートシステム (OSS) で相関と重複排除を適用します。 この API を拡張して、必須パラメーター、要求本文の検証、追加の REST 操作、およびフィールドマッピングをカスタマイズできます。詳細については、「 ア [ラーム管理オープン API 開発者ガイド](https://servicenow-prod.fluidtopics.net/mC5cS30fhYICskMNOwjb7g#alarm-mgmt_dev-guide "アラーム管理オープン API を使用して、イベント [em_event] テーブルのデータを作成および更新します。")。 アラーム管理オープン API は、TM フォーラムによって適合性認定を受けています。 ## アラーム管理オープン API -- GET /sn_ind_tmf642/alarm_mgmt/alarm {#ariaid-title2} イベント \[em_event\] テーブルとアラート \[em_alert\] テーブルからすべてのアラームレコードのリストを取得します。 ### URL 形式 デフォルト URL: /api/sn_ind_tmf642/alarm_mgmt/alarm ### サポートされている要求パラメーター {#alarm-GET-alarm__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 1. パスパラメーター] {#alarm-GET-alarm__table_qcn_fkm_qtb__entry__2} | 名前 | 説明 | |-|-| | alarmRaisedTime | アラームが発生した日付。このパラメーターの値と一致する日付のアラームのみが応答に返されます。 データタイプ：文字列 | | フィールド | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 有効なフィールド： * alarmedObject * alarmRaisedTime * アラームタイプ * crossedThresholdInformation * 外部アラーム ID * ID * 知覚された重大度 * probableCause * ソース * ソースシステム ID * 状況 * type {#alarm-GET-alarm__ul_n1h_htz_54b} デフォルト:すべてのフィールド データタイプ：文字列 | | ID | アラーム ID。このパラメーターの値と一致する ID を持つアラームのみが応答に返されます。 データタイプ：文字列 テーブル:イベント \[em_event\] テーブルの \[メッセージキー\] フィールド内。 | | limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、 offset パラメーターを使用してレコード取得をページネーションします。 デフォルト：1000 最大:2000 データタイプ：数値 | | オフセット | レコードの取得を開始する開始インデックス。この値を使用して、レコード取得をページネーションします。この機能を使用すると、レコードの数に関係なく、すべてのレコードを小さな管理可能なチャンクで取得できます。 データタイプ：数値 デフォルト：0 | | probableCause | アラームの考えられる原因。考えられる原因がこのパラメーターの値と一致するアラームのみが応答に返されます。 データタイプ：文字列 | | 状況 | アラームステータス。このパラメーターの値と一致するステータスのアラームのみが応答に返されます。 データタイプ：文字列 | | ソースシステム ID | アラームのソースシステム ID。このパラメーターの値と一致するソースシステム ID を持つアラームのみが応答に返されます。 データタイプ：文字列 | [表 : 2. クエリパラメーター] {#alarm-GET-alarm__table_qcn_fkm_qtb} {#alarm-GET-alarm__entry__24} | 名前 | 説明 | |-|-| | なし | | [表 : 3. 要求本文パラメーター (JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#alarm-GET-alarm__table_rgh_drm_qtb__entry__2} | ヘッダー | 説明 | |-|-| | なし | | [表 : 4. 要求ヘッダー] {#alarm-GET-alarm__table_rgh_drm_qtb} {#alarm-GET-alarm__table_c2r_4gm_lsb__entry__2}{#alarm-GET-alarm__content-range-row}{#alarm-GET-alarm__content-type-row}{#alarm-GET-alarm__links-pagination-row}{#alarm-GET-alarm__x-total-count-descr} | ヘッダー | 説明 | |-|-| | Content-Range | ページネーションされた呼び出しで返されるコンテンツの範囲。 たとえば、 `offset=2` で `limit=3` の場合、 Content-Range ヘッダーの値は `アイテム 3 から 5` です。 | | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | | 「リンク」 | クエリ結果間を移動するための次のリンクが含まれています。 * 第 1 * 最終 * 次へ * 前へ {#alarm-GET-alarm__ul_zzk_sdm_lsb} | | X-合計-数 | ページネーションされたクエリの場合、このヘッダーはサーバーで使用可能なレコードの合計数を指定します。 | [表 : 5. 応答ヘッダー] {#alarm-GET-alarm__table_c2r_4gm_lsb} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#alarm-GET-alarm__table_qbg_4cm_lsb__entry__2}{#alarm-GET-alarm__tmf-get-status-200-p}{#alarm-GET-alarm__tmf-get-status-206-entry}{#alarm-GET-alarm__tmf-get-status-400-entry}{#alarm-GET-alarm__tmf-get-status-404-entry} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に処理されました。応答で返された完全なリソース (ページネーションなし)。 | | 206 | 応答で返された部分的なリソース (ページネーションあり)。 | | 400 | 要求が正しくありません。考えられる理由: * 無効なパスパラメーター * 無効な URI {#alarm-GET-alarm__ul_rys_1gy_fsb} | | 404 | レコードが見つかりません。クエリパラメーターに一致するレコードがテーブルに見つかりません。 | [表 : 6. ステータスコード] {#alarm-GET-alarm__table_qbg_4cm_lsb} ### 応答本文のパラメーター (JSON) {#alarm-GET-alarm__table_zjc_fbg_qtb__entry__2}{#alarm-GET-alarm__alm-mgmt-affectedService-entry}{#alarm-GET-alarm__alm-mgmt-affectedServiceHREF-entry}{#alarm-GET-alarm__alm-mgmt-create-alarmobj-href-entry}{#alarm-GET-alarm__alm-mgmt-specificProb-ph} | 名前 | 説明 | |-|-| | affectedService | アラームの影響を受ける 1 つ以上のサービスのリスト。 データタイプ：オブジェクトのアレイ "affectedService":[ { "href": "String", "id": "String" }, ] | | affectedService.href | 影響を受けるサービスの詳細を提供する URL 参照。 データタイプ：文字列 | | affectedService.id | アラームの影響を受けるサービスの識別子。この値は、影響を受けるアラートの構成アイテム (CI) にマップされます。 データタイプ：文字列 | | アラームの詳細 | アラームに関するその他の詳細。 データタイプ：文字列 | | alarmedObject | アラームオブジェクトの詳細。 "alarmedObject": { "href": "String", "id": "String" } データタイプ: オブジェクト | | alarmedObject.id | アラームオブジェクトの一意の識別子。この値は、システム内の CI にマップされます。 データタイプ：文字列 | | alarmedObject.href | アラームオブジェクトの詳細を取得するための URL 参照。 データタイプ：文字列 | | alarmedObjectType | イベントに関連付けられたオブジェクトのタイプまたはクラス。 データタイプ：文字列 | | alarmRaisedTime | 発信元でアラームが発生した日時。 データタイプ：文字列 | | alarmReportingTime | OSS がアラームを報告する日時。 この値は alarmRaisedTime 値とは異なる場合があります。たとえば、要素管理システム (EMS) がアラームリストを管理している場合は、次のようになります。 * alarmRaisedTimeは、ネットワーク要素(NE)によるアラーム検出の時刻です。 * alarmReportingTimeは、EMSアラームリストに保存されているアラームレポート時間です。 {#alarm-GET-alarm__ul_mbt_1rf_ynb} データタイプ：文字列 | | アラームタイプ | アラームカテゴリ。 データタイプ：文字列 | | crossedThresholdInformation | 超過したしきい値に関する詳細。 データタイプ: オブジェクト "crossedThresholdInformation": { "direction": "String", "granularity": "String", "indicatorName": "String", "indicatorUnit": "String", "observedValue": "String", "thresholdCrossingDescription": "String", "thresholdId": "String", "thresholdRef": "String" } | | crossedThresholdInformation.direction | しきい値交差方向。 有効な値： * 下 * 上へ {#alarm-GET-alarm__ul_fsb_jlg_ynb} データタイプ：文字列 | | crossedThresholdInformation.granularity | インジケーターがしきい値を超えているかどうかを評価する粒度。たとえば、 `5MINUTES` などです。 データタイプ：文字列 | | crossedThresholdInformation.indicatorName | アラームしきい値を超えたインジケーターの名前。 データタイプ：文字列 | | crossedThresholdInformation.indicatorUnit | 超過しきい値に対応するインジケーターの測定単位。 データタイプ：文字列 | | crossedThresholdInformation.observedValue | しきい値を超えるインジケーターを識別する番号。 データタイプ：文字列 | | crossedThresholdInformation.thresholdCrossingDescription | しきい値超過アラームのしきい値の詳細。 データタイプ：文字列 | | crossedThresholdInformation.thresholdId | アラームの原因となったしきい値の一意の識別子。 データタイプ：文字列 | | crossedThresholdInformation.thresholdRef | しきい値オブジェクトの URL。 データタイプ：文字列 | | 外部アラーム ID | アラームを投稿するソースシステムからのアラームの一意の識別子。 データタイプ：文字列 | | href | resource の URL。 データタイプ：文字列 | | ID | アラームペイロードをイベントとして識別して処理するためのシステムの一意の識別子。 データ タイプ:文字列 | | 知覚された重大度 | アラーム重大度。 有効な値： * CLEAR * CRITICAL * メジャー * マイナー * WARNING {#alarm-GET-alarm__ul_vcp_c4f_ynb} データタイプ：文字列 | | plannedOutageIndication | このアラームの管理対象オブジェクトが予定されている機能停止ステータスであることを示します。たとえば、計画済みメンテナンスやサービス停止などです。 データタイプ：文字列 | | probableCause | アラームをトリガーする可能性が高い状況。アラームを認定するために alarmType とともに使用します。 データタイプ：文字列 | | proposedRepairAction | システムで利用可能な場合、アラームをトリガーする問題を解決するための修復アクションを提供します。 データタイプ：文字列 | | serviceAffecting | アラームがサービスに影響するかどうかを示すフラグ。 有効な値： * true:アラームはサービスのパフォーマンスまたは可用性に影響を与えます。 * false:アラームはサービスに影響を与えません。 {#alarm-GET-alarm__ul_omz_dnf_ynb} デフォルト値：false データタイプ：ブーリアン | | ソースシステム ID | ソースアラームのインスタンス ID。 データタイプ：文字列 | | 特定の問題 | アラームをトリガーする特定の問題。アラームを認定するには、 probableCause パラメーターとともに使用します。 データタイプ：文字列 | | 状況 | アラームステータス。 有効な値： * エラー * 無視 * 準備完了 * 処理日時 {#alarm-GET-alarm__ul_ilh_3jt_xnb}無効な値が指定された場合、ステータスは `[準備完了]` に設定されます。 ステータスが `[準備完了`\] の場合、アラート \[em_alert\] テーブルにアラートが作成され、ステータスが `[処理済み]` になります。 ステータスが `[処理済み]`、\[ `無視]`、または \[ `エラー` \] の場合、アラートは作成されません。 デフォルト値:準備完了 データタイプ：文字列 | [ ] {#alarm-GET-alarm__table_zjc_fbg_qtb} ### cURL 要求 この例では、すべてのアラームを取得します。 curl "https://instance.servicenow.com/api/sn_ind_tmf642/alarm_mgmt/alarm" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' 応答本文。 [ { "externalAlarmId": "2212331", "alarmType": "QualityOfServiceAlarm23", "perceivedSeverity": "MAJOR", "probableCause": "ProbB", "sourceSystemId": "checkSB", "alarmedObject": { "id": "vManage_000000", "href": " http://api/alarmedobject/000000" }, "crossedThresholdInformation": { "direction": "111", "granularity": "1234", "indicatorName": "sdfgds", "indicatorUnit": "asdfdsaf", "observedValue": "adsfds", "thresholdId": "12fasdfasdfasd", "thresholdCrossingDescription": "S23rtring", "thresholdRef": "asdfasf" }, "type": "QualityOfServiceAlarm", "ackState": "acknowledged", "specificProblem": "Inbound Traffic threshold crossed", "alarmedObjectType": "ROUTER", "alarmDetails": "Software Failure on SD-WAN Controller vManage_000000", "state": "processed", "alarmChangedTime": "2017-08-15T07:04:15.666Z", "proposedRepairActions": "Switch in standby equipment", "alarmReportingTime": "2017-06-15T07:04:15.666Z", "alarmRaisedTime": "2020-09-15T14:04:15.000Z", "plannedOutageIndication": "IN_SERVICE", "serviceAffecting": true, "affectedService": [ { "id": "SD WAN Enterprise Solutions", "href": "http://api/service/vlan_dot0_dot0" }, { "id": "Santa Clara SD WAN Application Service", "href": "http://api/service/vlan_dot0_dot0" } ], "source": "Alarm Management Open API", "href": "/api/sn_ind_tmf642/alarm_mgmt/alarm/001a0ca629078d10f87759e2f69e4c64_2212331", "id": "001a0ca629078d10f87759e2f69e4c64_2212331" }, { "externalAlarmId": "2212331", "alarmType": "QualityOfServiceAlarm23", "perceivedSeverity": "MAJOR", "probableCause": "ProbB", "sourceSystemId": "checkSB", "alarmedObject": { "id": "vManage_000000", "href": " http://api/alarmedobject/000000" }, "crossedThresholdInformation": { "direction": "111", "granularity": "1234", "indicatorName": "sdfgds", "indicatorUnit": "asdfdsaf", "observedValue": "adsfds", "thresholdId": "12fasdfasdfasd", "thresholdCrossingDescription": "S23rtring", "thresholdRef": "asdfasf" }, "type": "QualityOfServiceAlarm", "ackState": "acknowledged", "specificProblem": "Inbound Traffic threshold crossed", "alarmedObjectType": "ROUTER", "alarmDetails": "Software Failure on SD-WAN Controller vManage_000000", "state": "processed", "alarmChangedTime": "2017-08-15T07:04:15.666Z", "proposedRepairActions": "Switch in standby equipment", "alarmReportingTime": "2017-06-15T07:04:15.666Z", "alarmRaisedTime": "2020-09-15T14:04:15.000Z", "plannedOutageIndication": "IN_SERVICE", "serviceAffecting": true, "affectedService": [ { "id": "SD WAN Enterprise Solutions", "href": "http://api/service/vlan_dot0_dot0" }, { "id": "Santa Clara SD WAN Application Service", "href": "http://api/service/vlan_dot0_dot0" } ], "source": "Alarm Management Open API", "href": "/api/sn_ind_tmf642/alarm_mgmt/alarm/001c84aa29078d10f87759e2f69e4cfa_2212331", "id": "001c84aa29078d10f87759e2f69e4cfa_2212331" } ] ## アラーム管理オープン API -- GET /sn_ind_tmf642/alarm_mgmt/alarm/{id} {#ariaid-title3} 指定されたアラームレコードをイベント \[em_event\] テーブルまたはアラート \[em_alert\] テーブルから取得します。 ### URL 形式 デフォルト URL: /api/sn_ind_tmf642/alarm_mgmt/alarm/{id} ### サポートされている要求パラメーター {#alarm-GET-alarm-id__entry__2} | 名前 | 説明 | |-|-| | ID | 取得するレコードの一意の識別子。 データタイプ：文字列 テーブル:イベント \[em_event\] テーブルの \[メッセージキー\] フィールド内。 | [表 : 7. パスパラメーター] {#alarm-GET-alarm-id__entry__6} | 名前 | 説明 | |-|-| | フィールド | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 有効なフィールド： * alarmedObject * alarmRaisedTime * アラームタイプ * crossedThresholdInformation * 外部アラーム ID * ID * 知覚された重大度 * probableCause * ソース * ソースシステム ID * 状況 * type {#alarm-GET-alarm-id__ul_n1h_htz_54b} デフォルト値:すべてのフィールド データタイプ：文字列 | [表 : 8. クエリパラメーター] {#alarm-GET-alarm-id__entry__10} | 名前 | 説明 | |-|-| | なし | | [表 : 9. 要求本文パラメーター (JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#alarm-GET-alarm-id__entry__14}{#alarm-GET-alarm-id__accept-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 10. 要求ヘッダー] {#alarm-GET-alarm-id__entry__18} | ヘッダー | 説明 | |-|-| | なし | | [表 : 11. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#alarm-GET-alarm-id__entry__22}{#alarm-GET-alarm-id__entry-200-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。次の 1 つ以上の理由で、不正な要求タイプまたは誤った形式の要求が検出されました。 * パスパラメーターが無効です。 * 無効な URI。 {#alarm-GET-alarm-id__ul_rjf_fqw_rpb} | | 404 | レコードが見つかりません。指定された ID に関連付けられたレコードがイベント \[em_event\] テーブルまたはアラート \[em_alert\] テーブルに見つかりません。 | [表 : 12. ステータスコード] ### 応答本文のパラメーター (JSON) {#alarm-GET-alarm-id__table_gtd_dbg_qtb__entry__2}{#alarm-GET-alarm-id__alm-mgmt-affectedService-entry}{#alarm-GET-alarm-id__alm-mgmt-affectedServiceHREF-entry}{#alarm-GET-alarm-id__alm-mgmt-create-alarmobj-href-entry}{#alarm-GET-alarm-id__alm-mgmt-specificProb-ph} | 名前 | 説明 | |-|-| | affectedService | アラームの影響を受ける 1 つ以上のサービスのリスト。 データタイプ：オブジェクトのアレイ "affectedService":[ { "href": "String", "id": "String" }, ] | | affectedService.href | 影響を受けるサービスの詳細を提供する URL 参照。 データタイプ：文字列 | | affectedService.id | アラームの影響を受けるサービスの識別子。この値は、影響を受けるアラートの構成アイテム (CI) にマップされます。 データタイプ：文字列 | | アラームの詳細 | アラームに関するその他の詳細。 データタイプ：文字列 | | alarmedObject | アラームオブジェクトの詳細。 データタイプ: オブジェクト "alarmedObject": { "href": "String", "id": "String" } | | alarmedObject.id | アラームオブジェクトの一意の識別子。この値は、システム内の CI にマップされます。 データタイプ：文字列 | | alarmedObject.href | アラームオブジェクトの詳細を取得するための URL 参照。 データタイプ：文字列 | | alarmedObjectType | イベントに関連付けられたオブジェクトのタイプまたはクラス。 データタイプ：文字列 | | alarmRaisedTime | 発信元でアラームが発生した日時。 データタイプ：文字列 | | alarmReportingTime | OSS がアラームを報告する日時。 この値は alarmRaisedTime 値とは異なる場合があります。たとえば、要素管理システム (EMS) がアラームリストを管理している場合は、次のようになります。 * alarmRaisedTimeは、ネットワーク要素(NE)によるアラーム検出の時刻です。 * alarmReportingTimeは、EMSアラームリストに保存されているアラームレポート時間です。 {#alarm-GET-alarm-id__ul_mbt_1rf_ynb} データタイプ：文字列 | | アラームタイプ | アラームカテゴリ。 データタイプ：文字列 | | crossedThresholdInformation | 超過したしきい値に関する詳細。 データタイプ: オブジェクト "crossedThresholdInformation": { "direction": "String", "granularity": "String", "indicatorName": "String", "indicatorUnit": "String", "observedValue": "String", "thresholdCrossingDescription": "String", "thresholdId": "String", "thresholdRef": "String" } | | crossedThresholdInformation.direction | しきい値交差方向。 有効な値： * 下 * 上へ {#alarm-GET-alarm-id__ul_fsb_jlg_ynb} データタイプ：文字列 | | crossedThresholdInformation.granularity | インジケーターがしきい値を超えているかどうかを評価する粒度。たとえば、 `5MINUTES` などです。 データタイプ：文字列 | | crossedThresholdInformation.indicatorName | アラームしきい値を超えたインジケーターの名前。 データタイプ：文字列 | | crossedThresholdInformation.indicatorUnit | 超過しきい値に対応するインジケーターの測定単位。 データタイプ：文字列 | | crossedThresholdInformation.observedValue | しきい値を超えるインジケーターを識別する番号。 データタイプ：文字列 | | crossedThresholdInformation.thresholdCrossingDescription | しきい値超過アラームのしきい値の詳細。 データタイプ：文字列 | | crossedThresholdInformation.thresholdId | アラームの原因となったしきい値の一意の識別子。 データタイプ：文字列 | | crossedThresholdInformation.thresholdRef | しきい値オブジェクトの URL。 データタイプ：文字列 | | 外部アラーム ID | アラームを投稿するソースシステムからのアラームの一意の識別子。 データタイプ：文字列 | | href | リソースの URL。 データタイプ：文字列 | | ID | アラームペイロードをイベントとして識別して処理するためのシステムの一意の識別子。 データタイプ：文字列 | | 知覚された重大度 | アラーム重大度。 有効な値： * CLEAR * CRITICAL * メジャー * マイナー * WARNING {#alarm-GET-alarm-id__ul_vcp_c4f_ynb} データタイプ：文字列 | | plannedOutageIndication | このアラームの管理対象オブジェクトが予定されている機能停止ステータスであることを示します。たとえば、計画済みメンテナンスやサービス停止などです。 データタイプ：文字列 | | probableCause | アラームをトリガーする可能性が高い状況。アラームを認定するために alarmType とともに使用します。 データタイプ：文字列 | | proposedRepairAction | システムで利用可能な場合、アラームをトリガーする問題を解決するための修復アクションを提供します。 データタイプ：文字列 | | serviceAffecting | アラームがサービスに影響するかどうかを示すフラグ。 有効な値： * true:アラームはサービスのパフォーマンスまたは可用性に影響を与えます。 * false:アラームはサービスに影響を与えません。 {#alarm-GET-alarm-id__ul_omz_dnf_ynb} デフォルト値：false データタイプ：ブーリアン | | ソースシステム ID | ソースアラームのインスタンス ID。 データタイプ：文字列 | | 特定の問題 | アラームをトリガーする特定の問題。アラームを認定するには、 probableCause パラメーターとともに使用します。 データタイプ：文字列 | | 状況 | アラームステータス。 有効な値： * エラー * 無視 * 準備完了 * 処理日時 {#alarm-GET-alarm-id__ul_ilh_3jt_xnb}無効な値が指定された場合、ステータスは `[準備完了]` に設定されます。 ステータスが `[準備完了`\] の場合、アラート \[em_alert\] テーブルにアラートが作成され、ステータスが `[処理済み]` になります。 ステータスが `[処理済み]`、\[ `無視]`、または \[ `エラー` \] の場合、アラートは作成されません。 デフォルト値:準備完了 データタイプ：文字列 | [ ] {#alarm-GET-alarm-id__table_gtd_dbg_qtb} ### cURL 要求 この例では、アラームを取得します。 curl "https://instance.servicenow.com/api/sn_ind_tmf642/alarm_mgmt/alarm/001a0ca629078d10f87759e2f69e4c64_2212331" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' 応答本文。 { "externalAlarmId": "2212331", "alarmType": "QualityOfServiceAlarm23", "perceivedSeverity": "MAJOR", "probableCause": "ProbB", "sourceSystemId": "checkSB", "alarmedObject": { "id": "vManage_000000", "href": " http://api/alarmedobject/000000" }, "crossedThresholdInformation": { "direction": "111", "granularity": "1234", "indicatorName": "ind_name", "indicatorUnit": "ind_unit", "observedValue": "232", "thresholdId": "200", "thresholdCrossingDescription": "sample_description", "thresholdRef": "sample_ref" }, "type": "QualityOfServiceAlarm", "ackState": "acknowledged", "specificProblem": "Inbound Traffic threshold crossed", "alarmedObjectType": "ROUTER", "alarmDetails": "Software Failure on SD-WAN Controller vManage_000000", "state": "processed", "alarmChangedTime": "2017-08-15T07:04:15.666Z", "proposedRepairActions": "Switch in standby equipment", "alarmReportingTime": "2017-06-15T07:04:15.666Z", "alarmRaisedTime": "2020-09-15T14:04:15.000Z", "plannedOutageIndication": "IN_SERVICE", "serviceAffecting": true, "affectedService": [ { "id": "SD WAN Enterprise Solutions", "href": "http://api/service/vlan_dot0_dot0" }, { "id": "Santa Clara SD WAN Application Service", "href": "http://api/service/vlan_dot0_dot0" } ], "source": "Alarm Management Open API", "href": "/api/sn_ind_tmf642/alarm_mgmt/alarm/001a0ca629078d10f87759e2f69e4c64_2212331", "id": "001a0ca629078d10f87759e2f69e4c64_2212331" } ## アラーム管理オープン API -- PATCH /sn_ind_tmf642/alarm_mgmt/alarm/{id} {#ariaid-title4} 指定されたアラームと関連するアラートを更新します。 このエンドポイントは、応答本文をイベント \[em_event\] テーブルのイベントレコードの \[追加情報 \] フィールドに書き込みます。 ### URL 形式 デフォルト URL: /api/sn_ind_tmf642/alarm_mgmt/alarm/{id} ### サポートされている要求パラメーター {#alarm-PATCH__entry__2} | 名前 | 説明 | |-|-| | ID | 更新するレコードの一意の識別子。 データタイプ：文字列 テーブル:イベント \[em_event\] テーブルの \[メッセージキー\] フィールド内。 | [表 : 13. パスパラメーター] {#alarm-PATCH__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 14. クエリパラメーター] {#alarm-PATCH__table_kmr_mjs_xnb__entry__2}{#alarm-PATCH__alm-mgmt-affectedService-entry}{#alarm-PATCH__alm-mgmt-affectedServiceHREF-entry}{#alarm-PATCH__alm-mgmt-perceivedSeverity-desc}{#alarm-PATCH__alm-mgmt-specificProb-ph} | 名前 | 説明 | |-|-| | affectedService | アラームの影響を受ける 1 つ以上のサービスのリスト。 データタイプ：オブジェクトのアレイ "affectedService":[ { "href": "String", "id": "String" }, ] | | affectedService.href | 影響を受けるサービスの詳細を提供する URL 参照。 データタイプ：文字列 | | affectedService.id | 必須です。 アラームの影響を受けるサービスの識別子。この値は、影響を受けるアラートの構成アイテム (CI) にマップされます。 データタイプ：文字列 | | アラーム変更時間 | アラーム所有システムでアラームが最後に変更された日時を示します。アラームを変更すると、アラーム対象のリソースからの値か、クライアントからの変更によってトリガーされるかにかかわらず、この値が更新されます。 データタイプ：文字列 | | アラームの詳細 | アラームに関するその他の詳細。 データタイプ：文字列 | | アラームエスカレーション | アラーム重大度のエスカレーションを示すフラグ。 有効な値： * true:アラーム重大度がエスカレーションされています。 * false:アラーム重大度は同等かそれ以下です。 {#alarm-PATCH__ul_kkj_4jh_ynb} デフォルト値：false データタイプ：ブーリアン | | crossedThresholdInformation | 超過したしきい値に関する詳細。 データタイプ: オブジェクト "crossedThresholdInformation": { "direction": "String", "granularity": "String", "indicatorName": "String", "indicatorUnit": "String", "observedValue": "String", "thresholdCrossingDescription": "String", "thresholdId": "String", "thresholdRef": "String" } | | crossedThresholdInformation.direction | しきい値交差方向。 有効な値： * 下 * 上へ {#alarm-PATCH__ul_fsb_jlg_ynb} データタイプ：文字列 | | crossedThresholdInformation.granularity | インジケーターがしきい値を超えているかどうかを評価する粒度。たとえば、 `5MINUTES` などです。 データタイプ：文字列 | | crossedThresholdInformation.indicatorName | アラームしきい値を超えたインジケーターの名前。 データタイプ：文字列 | | crossedThresholdInformation.indicatorUnit | 超過しきい値に対応するインジケーターの測定単位。 データタイプ：文字列 | | crossedThresholdInformation.observedValue | しきい値を超えるインジケーターを識別する番号。 データタイプ：文字列 | | crossedThresholdInformation.thresholdCrossingDescription | しきい値超過アラームのしきい値の詳細。 データタイプ：文字列 | | crossedThresholdInformation.thresholdId | 必須です。 アラームの原因となったしきい値の一意の識別子。 データタイプ：文字列 | | crossedThresholdInformation.thresholdRef | しきい値オブジェクトの URL。 データタイプ：文字列 | | href | アラームへの URL 参照。 データタイプ：文字列 | | 知覚された重大度 | 必須です。アラーム重大度。 有効な値： * CLEAR * CRITICAL * メジャー * マイナー * WARNING {#alarm-PATCH__ul_vcp_c4f_ynb} データタイプ：文字列 | | plannedOutageIndication | このアラームの管理対象オブジェクトが予定されている機能停止ステータスであることを示します。たとえば、計画済みメンテナンスやサービス停止などです。 データタイプ：文字列 | | probableCause | 必須です。 アラームをトリガーする可能性が高い状況。アラームを認定するために alarmType とともに使用します。 データタイプ：文字列 | | proposedRepairAction | システムで利用可能な場合、アラームをトリガーする問題を解決するための修復アクションを提供します。 データタイプ：文字列 | | serviceAffecting | アラームがサービスに影響するかどうかを示すフラグ。 有効な値： * true:アラームはサービスのパフォーマンスまたは可用性に影響を与えます。 * false:アラームはサービスに影響を与えません。 {#alarm-PATCH__ul_omz_dnf_ynb} デフォルト値：false データタイプ：ブーリアン | | 特定の問題 | アラームをトリガーする特定の問題。アラームを認定するには、 probableCause パラメーターとともに使用します。 データタイプ：文字列 | [表 : 15. 要求本文パラメーター (JSON)] {#alarm-PATCH__table_kmr_mjs_xnb} ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#alarm-PATCH__entry__56}{#alarm-PATCH__accept-JSON-only-entry-RESTAPI}{#alarm-PATCH__content_type-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 16. 要求ヘッダー] {#alarm-PATCH__table_jwc_bxs_xnb__entry__2} | ヘッダー | 説明 | |-|-| | なし | | [表 : 17. 応答ヘッダー] {#alarm-PATCH__table_jwc_bxs_xnb} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#alarm-PATCH__table_ifj_lyb_ynb__entry__2} | ステータスコード | 説明 | |-|-| | 201 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。 考えられる理由: * 無効なペイロードです。必要なアラーム ID がありません。 * 無効なペイロードです。必須フィールドがありません:\。 * 無効なペイロードです。必要なオブジェクトがありません。 * イベントが作成されていないか、失敗しました。 * イベントをクリアできません。 * イベントを更新できません。 * イベントが存在しません。 {#alarm-PATCH__ul_f4x_sdb_ynb} | [表 : 18. ステータスコード] {#alarm-PATCH__table_ifj_lyb_ynb} ### 応答本文のパラメーター (JSON) {#alarm-PATCH__entry__72} | 名前 | 説明 | |-|-| | アラーム変更時間 | アラーム所有システムでアラームが変更された日時 (GMT)。この値は、アラーム対象のリソースからアラームが変更されたとき、またはクライアントの更新からの変更によってアラームがトリガーされたときに更新されます。 この値は応答で必須です。 データタイプ：文字列 | | href | アラームへの URL 参照。 データタイプ：文字列 | | ID | アラームの一意の識別子。アラームを所有するシステムによって決定される値。 データタイプ：文字列 | [ ] ### cURL 要求 この例では、重大度は \[マイナー\] に軽減されています。 curl "https://.service-now.com/api/sn_ind_tmf642/alarm_mgmt/alarm/6e116bb8db09201087b9a8394b961950_" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"href\":\"http://api/alarm/ROUTER_IF@Cisco-0000-0-0-0-0-00-00-0-- Xz0/00@00\", \"externalAlarmId\":\"\", \"alarmType\":\"QualityOfServiceAlarm\", \"type\":\"QualityOfServiceAlarm\", \"ackState\":\"acknowledged\", \"perceivedSeverity\":\"MINOR\", \"probableCause\":\"Threshold crossed\", \"specificProblem\":\"Inbound Traffic threshold crossed\", \"alarmedObjectType\":\"ROUTER\", \"alarmedObject\":{ \"id\":\"vManage_000000\", \"href\":\" http://api/alarmedobject/000000\" }, \"sourceSystemId\":\"SOURCE_SYSTEM_vManage_00000_000_00\", \"alarmDetails\":\"Software Failure on SD-WAN Controller vManage_000000\", \"alarmEscalation\": false, \"state\":\"RAISED\", \"alarmChangedTime\":\"2017-08-15T07:04:15.666Z\", \"proposedRepairActions\":\"Switch in standby equipment\", \"alarmReportingTime\":\"2017-06-15T07:04:15.666Z\", \"alarmRaisedTime\":\"2020-09-15T07:04:15.666Z\", \"plannedOutageIndication\":\"IN_SERVICE\", \"serviceAffecting\":true, \"affectedService\":[ { \"id\":\"SD WAN Enterprise Solutions\", \"href\":\"http://api/service/vlan_dot0_dot0\" }, { \"id\":\"Santa Clara SD WAN Application Service\", \"href\":\"http://api/service/vlan_dot0_dot0\" } ] }" \ --user 'user:'password' 応答本文。 { "result": { "alarmChangedTime": "2017-08-15T07:04:15.666Z", "id": "6e116bb8db09201087b9a8394b961950_" } } ## アラーム管理オープンAPI -- POST /sn_ind_tmf642/alarm_mgmt/アラーム {#ariaid-title5} イベント \[em_event\] テーブルにアラームレコードを作成します。 アラームレコードが作成されると、アラームの ID が \[ Message key \] フィールドに追加されます。 アラート [管理ルール](https://www.servicenow.com/docs/access?context=alert-management-rule&version=australia&pubname=australia-it-operations-management&ft:locale=en-US)に基づいてアラートレコードを作成することもできます。 このエンドポイントは、応答本文をイベント \[em_event\] テーブルのイベントレコードの \[追加情報 \] フィールドに書き込みます。 ### URL 形式 デフォルト URL: /api/sn_ind_tmf642/alarm_mgmt/alarm ### サポートされている要求パラメーター {#alarm-POST-create__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 19. パスパラメーター] {#alarm-POST-create__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 20. クエリパラメーター] {#alarm-POST-create__entry__10}{#alarm-POST-create__alm-mgmt-affectedService-entry}{#alarm-POST-create__alm-mgmt-affectedServiceHREF-entry}{#alarm-POST-create__alm-mgmt-create-alarmobj-href-entry}{#alarm-POST-create__alm-mgmt-create-alarmtype}{#alarm-POST-create__alm-mgmt-perceivedSeverity-desc}{#alarm-POST-create__alm-mgmt-specificProb-ph} | 名前 | 説明 | |-|-| | affectedService | アラームの影響を受ける 1 つ以上のサービスのリスト。 データタイプ：オブジェクトのアレイ "affectedService":[ { "href": "String", "id": "String" }, ] | | affectedService.href | 影響を受けるサービスの詳細を提供する URL 参照。 データタイプ：文字列 | | affectedService.id | 必須です。 アラームの影響を受けるサービスの識別子。この値は、影響を受けるアラートの構成アイテム (CI) にマップされます。 データタイプ：文字列 | | アラームの詳細 | アラームに関するその他の詳細。 データタイプ：文字列 | | alarmedObject | 必須です。 アラームオブジェクトの詳細。 "alarmedObject": { "href": "String", "id": "String" } データタイプ: オブジェクト | | alarmedObject.id | 必須です。 アラームオブジェクトの一意の識別子。この値は、システム内の CI にマップされます。 データタイプ：文字列 | | alarmedObject.href | アラームオブジェクトの詳細を取得するための URL 参照。 データタイプ：文字列 | | alarmedObjectType | イベントに関連付けられたオブジェクトのタイプまたはクラス。 データタイプ：文字列 | | alarmRaisedTime | 発信元でアラームが発生した日時。 データタイプ：文字列 | | alarmReportingTime | OSS がアラームを報告する日時。 この値は alarmRaisedTime 値とは異なる場合があります。たとえば、要素管理システム (EMS) がアラームリストを管理している場合は、次のようになります。 * alarmRaisedTimeは、ネットワーク要素(NE)によるアラーム検出の時刻です。 * alarmReportingTimeは、EMSアラームリストに保存されているアラームレポート時間です。 {#alarm-POST-create__ul_mbt_1rf_ynb} データタイプ：文字列 | | アラームタイプ | 必須です。 アラームカテゴリ。 データタイプ：文字列 | | crossedThresholdInformation | 超過したしきい値に関する詳細。 データタイプ: オブジェクト "crossedThresholdInformation": { "direction": "String", "granularity": "String", "indicatorName": "String", "indicatorUnit": "String", "observedValue": "String", "thresholdCrossingDescription": "String", "thresholdId": "String", "thresholdRef": "String" } | | crossedThresholdInformation.direction | しきい値交差方向。 有効な値： * 下 * 上へ {#alarm-POST-create__ul_fsb_jlg_ynb} データタイプ：文字列 | | crossedThresholdInformation.granularity | インジケーターがしきい値を超えているかどうかを評価する粒度。たとえば、 `5MINUTES` などです。 データタイプ：文字列 | | crossedThresholdInformation.indicatorName | アラームしきい値を超えたインジケーターの名前。 データタイプ：文字列 | | crossedThresholdInformation.indicatorUnit | 超過しきい値に対応するインジケーターの測定単位。 データタイプ：文字列 | | crossedThresholdInformation.observedValue | しきい値を超えるインジケーターを識別する番号。 データタイプ：文字列 | | crossedThresholdInformation.thresholdCrossingDescription | しきい値超過アラームのしきい値の詳細。 データタイプ：文字列 | | crossedThresholdInformation.thresholdId | 必須です。 アラームの原因となったしきい値の一意の識別子。 データタイプ：文字列 | | crossedThresholdInformation.thresholdRef | しきい値オブジェクトの URL。 データタイプ：文字列 | | 外部アラーム ID | 必須です。 アラームを投稿するソースシステムからのアラームの一意の識別子。 データタイプ：文字列 | | ID | アラームペイロードをイベントとして識別して処理するためのシステムの一意の識別子。 ペイロードで使用する場合は、この値を空にする必要があります。このイベントの一意の ID が生成され、応答ペイロードの一部として送信されます。 データタイプ：文字列 | | 知覚された重大度 | 必須です。アラーム重大度。 有効な値： * CLEAR * CRITICAL * メジャー * マイナー * WARNING {#alarm-POST-create__ul_vcp_c4f_ynb} データタイプ：文字列 | | plannedOutageIndication | このアラームの管理対象オブジェクトが予定されている機能停止ステータスであることを示します。たとえば、計画済みメンテナンスやサービス停止などです。 データタイプ：文字列 | | probableCause | 必須です。 アラームをトリガーする可能性が高い状況。アラームを認定するために alarmType とともに使用します。 データタイプ：文字列 | | proposedRepairAction | システムで利用可能な場合、アラームをトリガーする問題を解決するための修復アクションを提供します。 データタイプ：文字列 | | serviceAffecting | アラームがサービスに影響するかどうかを示すフラグ。 有効な値： * true:アラームはサービスのパフォーマンスまたは可用性に影響を与えます。 * false:アラームはサービスに影響を与えません。 {#alarm-POST-create__ul_omz_dnf_ynb} デフォルト値：false データタイプ：ブーリアン | | ソースシステム ID | 必須です。 ソースアラームのインスタンス ID。 データタイプ：文字列 | | 特定の問題 | アラームをトリガーする特定の問題。アラームを認定するには、 probableCause パラメーターとともに使用します。 データタイプ：文字列 | | 状況 | アラームステータス。 有効な値： * エラー * 無視 * 準備完了 * 処理日時 {#alarm-POST-create__ul_ilh_3jt_xnb}無効な値が指定された場合、ステータスは `[準備完了]` に設定されます。 ステータスが `[準備完了`\] の場合、アラート \[em_alert\] テーブルにアラートが作成され、ステータスが `[処理済み]` になります。 ステータスが `[処理済み]`、\[ `無視]`、または \[ `エラー` \] の場合、アラートは作成されません。 デフォルト値:準備完了 データタイプ：文字列 | [表 : 21. 要求本文パラメーター (JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#alarm-POST-create__entry__72}{#alarm-POST-create__accept-JSON-only-entry-RESTAPI}{#alarm-POST-create__content_type-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 22. 要求ヘッダー] {#alarm-POST-create__table_vrm_1xs_xnb__entry__2} | ヘッダー | 説明 | |-|-| | なし | | [表 : 23. 応答ヘッダー] {#alarm-POST-create__table_vrm_1xs_xnb} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#alarm-POST-create__table_bly_lyb_ynb__entry__2} | ステータスコード | 説明 | |-|-| | 201 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。 考えられる理由: * 無効なペイロードです。必要なアラーム ID がありません。 * 無効なペイロードです。必須フィールドがありません:\。 * 無効なペイロードです。必要なオブジェクトがありません。 * イベントが作成されていないか、失敗しました。 * イベントをクリアできません。 * イベントを更新できません。 * イベントが存在しません。 {#alarm-POST-create__ul_f4x_sdb_ynb} | [表 : 24. ステータスコード] {#alarm-POST-create__table_bly_lyb_ynb} ### 応答本文のパラメーター (JSON) {#alarm-POST-create__entry__88}{#alarm-POST-create__d3882e76}{#alarm-POST-create__d3882e89}{#alarm-POST-create__d3882e404}{#alarm-POST-create__d3882e343} | 名前 | 説明 | |-|-| | affectedService | アラームの影響を受ける 1 つ以上のサービスのリスト。 データタイプ：オブジェクトのアレイ "affectedService":[ { "href": "String", "id": "String" }, ] | | affectedService.href | 影響を受けるサービスの詳細を提供する URL 参照。 データタイプ：文字列 | | affectedService.id | アラームの影響を受けるサービスの識別子。この値は、影響を受けるアラートの構成アイテム (CI) にマップされます。 データタイプ：文字列 | | アラームの詳細 | アラームに関するその他の詳細。 データタイプ：文字列 | | alarmedObject | アラームオブジェクトの詳細。 "alarmedObject": { "href": "String", "id": "String" } データタイプ: オブジェクト | | alarmedObject.id | アラームオブジェクトの一意の識別子。この値は、システム内の CI にマップされます。 データタイプ：文字列 | | alarmedObject.href | アラームオブジェクトの詳細を取得するための URL 参照。 データタイプ：文字列 | | alarmedObjectType | イベントに関連付けられたオブジェクトのタイプまたはクラス。 データタイプ：文字列 | | alarmRaisedTime | 発信元でアラームが発生した日時。 データタイプ：文字列 | | alarmReportingTime | OSS がアラームを報告する日時。 この値は alarmRaisedTime 値とは異なる場合があります。たとえば、要素管理システム (EMS) がアラームリストを管理している場合は、次のようになります。 * alarmRaisedTimeは、ネットワーク要素(NE)によるアラーム検出の時刻です。 * alarmReportingTimeは、EMSアラームリストに保存されているアラームレポート時間です。 {#alarm-POST-create__d3882e460} データタイプ：文字列 | | アラームタイプ | アラームカテゴリ。 データタイプ：文字列 | | crossedThresholdInformation | 超過したしきい値に関する詳細。 データタイプ: オブジェクト "crossedThresholdInformation": { "direction": "String", "granularity": "String", "indicatorName": "String", "indicatorUnit": "String", "observedValue": "String", "thresholdCrossingDescription": "String", "thresholdId": "String", "thresholdRef": "String" } | | crossedThresholdInformation.direction | しきい値交差方向。 有効な値： * 下 * 上へ {#alarm-POST-create__d3882e144} データタイプ：文字列 | | crossedThresholdInformation.granularity | インジケーターがしきい値を超えているかどうかを評価する粒度。たとえば、 `5MINUTES` などです。 データタイプ：文字列 | | crossedThresholdInformation.indicatorName | アラームしきい値を超えたインジケーターの名前。 データタイプ：文字列 | | crossedThresholdInformation.indicatorUnit | 超過しきい値に対応するインジケーターの測定単位。 データタイプ：文字列 | | crossedThresholdInformation.observedValue | しきい値を超えるインジケーターを識別する番号。 データタイプ：文字列 | | crossedThresholdInformation.thresholdCrossingDescription | しきい値超過アラームのしきい値の詳細。 データタイプ：文字列 | | crossedThresholdInformation.thresholdId | アラームの原因となったしきい値の一意の識別子。 データタイプ：文字列 | | crossedThresholdInformation.thresholdRef | しきい値オブジェクトの URL。 データタイプ：文字列 | | 外部アラーム ID | アラームを投稿するソースシステムからのアラームの一意の識別子。 データタイプ：文字列 | | href | リソースの URL。 データタイプ：文字列 | | ID | アラームペイロードをイベントとして識別して処理するためのシステムの一意の識別子。 データタイプ：文字列 | | 知覚された重大度 | アラーム重大度。 有効な値： * CLEAR * CRITICAL * メジャー * マイナー * WARNING {#alarm-POST-create__d3882e253} データタイプ：文字列 | | plannedOutageIndication | このアラームの管理対象オブジェクトが予定されている機能停止ステータスであることを示します。たとえば、計画済みメンテナンスやサービス停止などです。 データタイプ：文字列 | | probableCause | アラームをトリガーする可能性が高い状況。アラームを認定するために alarmType とともに使用します。 データタイプ：文字列 | | proposedRepairAction | システムで利用可能な場合、アラームをトリガーする問題を解決するための修復アクションを提供します。 データタイプ：文字列 | | serviceAffecting | アラームがサービスに影響するかどうかを示すフラグ。 有効な値： * true:アラームはサービスのパフォーマンスまたは可用性に影響を与えます。 * false:アラームはサービスに影響を与えません。 {#alarm-POST-create__d3882e323} デフォルト値：false データタイプ：ブーリアン | | ソースシステム ID | ソースアラームのインスタンス ID。 データタイプ：文字列 | | 特定の問題 | アラームをトリガーする特定の問題。アラームを認定するには、 probableCause パラメーターとともに使用します。 データタイプ：文字列 | | 状況 | アラームステータス。 有効な値： * エラー * 無視 * 準備完了 * 処理日時 {#alarm-POST-create__d3882e539}無効な値が指定された場合、ステータスは `[準備完了]` に設定されます。 ステータスが `[準備完了`\] の場合、アラート \[em_alert\] テーブルにアラートが作成され、ステータスが `[処理済み]` になります。 ステータスが `[処理済み]`、\[ `無視]`、または \[ `エラー` \] の場合、アラートは作成されません。 デフォルト値:準備完了 データタイプ：文字列 | [ ] ### cURL 要求 この例では、アラームを作成します。 curl "https://.service-now.com/api/sn_ind_tmf642/alarm_mgmt/alarm" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ "href":"http://api/alarm/ROUTER_IF@Cisco-0000-0-0-0-0-00-00-0-- Xz0/00@00", "externalAlarmId":"", "alarmType":"QualityOfServiceAlarm", "type":"QualityOfServiceAlarm", "ackState":"acknowledged", "perceivedSeverity":"CRITICAL", "probableCause":"Threshold crossed", "specificProblem":"Inbound Traffic threshold crossed", "alarmedObjectType":"ROUTER", "alarmedObject":{ "id":"vManage_000000", "href":" http://api/alarmedobject/000000" }, "sourceSystemId":"SOURCE_SYSTEM_vManage_00000_000_00", "alarmDetails":"Software Failure on SD-WAN Controller vManage_000000", "state":"RAISED", "alarmChangedTime":"2017-08-15T07:04:15.666Z", "proposedRepairActions":"Switch in standby equipment", "alarmReportingTime":"2017-06-15T07:04:15.666Z", "alarmRaisedTime":"2020-09-15T07:04:15.666Z", "plannedOutageIndication":"IN_SERVICE", "serviceAffecting":true, "affectedService":[ { "id":"SD WAN Enterprise Solutions", "href":"http://api/service/vlan_dot0_dot0" }, { "id":"Santa Clara SD WAN Application Service", "href":"http://api/service/vlan_dot0_dot0" } ] }" \ --user 'user':'password' 応答本文。 { "href":"http://api/alarm/ROUTER_IF@Cisco-0000-0-0-0-0-00-00-0-- Xz0/00@00", "externalAlarmId":"", "alarmType":"QualityOfServiceAlarm", "type":"QualityOfServiceAlarm", "ackState":"acknowledged", "perceivedSeverity":"CRITICAL", "probableCause":"Threshold crossed", "specificProblem":"Inbound Traffic threshold crossed", "alarmedObjectType":"ROUTER", "alarmedObject":{ "id":"vManage_000000", "href":" http://api/alarmedobject/000000" }, "sourceSystemId":"SOURCE_SYSTEM_vManage_00000_000_00", "alarmDetails":"Software Failure on SD-WAN Controller vManage_000000", "state":"RAISED", "alarmChangedTime":"2017-08-15T07:04:15.666Z", "proposedRepairActions":"Switch in standby equipment", "alarmReportingTime":"2017-06-15T07:04:15.666Z", "alarmRaisedTime":"2020-09-15T07:04:15.666Z", "plannedOutageIndication":"IN_SERVICE", "serviceAffecting":true, "affectedService":[ { "id":"SD WAN Enterprise Solutions", "href":"http://api/service/vlan_dot0_dot0" }, { "id":"Santa Clara SD WAN Application Service", "href":"http://api/service/vlan_dot0_dot0" } ] } ## アラーム管理オープン API -- POST /sn_ind_tmf642/alarm_mgmt/alarm/{id}/clear {#ariaid-title6} 指定されたアラームをクリアし、関連するアラートをすべてクローズします。 ### URL 形式 デフォルト URL: /api/sn_ind_tmf642/alarm_mgmt/alarm/{id}/clear ### サポートされている要求パラメーター {#alarm-POST-clear__entry__2} | 名前 | 説明 | |-|-| | ID | クリアするアラームの一意の識別子。 データタイプ：文字列 テーブル:イベント \[em_events\] テーブルの \[メッセージキー\] フィールド内。 | [表 : 25. パスパラメーター] {#alarm-POST-clear__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 26. クエリパラメーター] {#alarm-POST-clear__entry__10} | 名前 | 説明 | |-|-| | アラームクリア時間 | ソースでアラームがクリアされた日時。 データタイプ：文字列 テーブル:イベント \[em_events\] テーブルの \[イベントの時刻\] フィールド内。 | | clearSystemId | 必須です。 alarmCleared操作が呼び出されたインスタンスの名前。 データタイプ：文字列 | | clearUserId | 必須です。 alarmCleared操作を呼び出したユーザーの一意の ID。 データタイプ：文字列 | [表 : 27. 要求本文パラメーター (JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#alarm-POST-clear__entry__18}{#alarm-POST-clear__accept-JSON-only-entry-RESTAPI}{#alarm-POST-clear__content_type-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 28. 要求ヘッダー] {#alarm-POST-clear__entry__24} | 名前 | 説明 | |-|-| | なし | | [表 : 29. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#alarm-POST-clear__entry__28} | ステータスコード | 説明 | |-|-| | 201 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。 考えられる理由: * 無効なペイロードです。必要なアラーム ID がありません。 * 無効なペイロードです。必須フィールドがありません:\。 * 無効なペイロードです。必要なオブジェクトがありません。 * イベントが作成されていないか、失敗しました。 * イベントをクリアできません。 * イベントを更新できません。 * イベントが存在しません。 {#alarm-POST-clear__ul_f4x_sdb_ynb} | [表 : 30. ステータスコード] ### 応答本文のパラメーター (JSON) {#alarm-POST-clear__entry__34} | 名前 | 説明 | |-|-| | アラームクリア時間 | ソースでアラームがクリアされた日時。 データタイプ：文字列 テーブル:イベント \[em_events\] テーブルの \[イベントの時刻\] フィールド内。 | | clearSystemId | alarmCleared操作が呼び出されたインスタンスの名前。 データタイプ：文字列 | | clearUserId | alarmCleared操作を呼び出したユーザーの一意の ID。 データタイプ：文字列 | | href | アラームの URL。 データタイプ：文字列 | | ID | 一意の ID。 データタイプ：文字列 テーブル:イベント \[em_events\] テーブルのレコードの \[メッセージキー\] フィールド内。 | [ ] ### cURL 要求 この例では、アラームをクリアします。 curl "https://.service-now.com/api/sn_ind_tmf642/alarm_mgmt/alarm/6e116bb8db09201087b9a8394b961950_/clear" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"alarmClearedTime\": \"2017-08-15 06:04:15\", \"clearSystemId\": \"\", \"clearUserId\": \"SOURCE_SYSTEM_vManage_00000_000_00\" }" \ --user 'user':'password' 応答本文。 { "result": { "alarmClearedTime": "2017-08-15 06:04:15", "clearSystemId": "", "clearUserId": "SOURCE_SYSTEM_vManage_00000_000_00", "id": "6e116bb8db09201087b9a8394b961950_" } }