REST API 変更ログ
最終更新日: 14 年 2025 月 XNUMX 日この記事では、各バージョンでの LogicMonitor REST API の変更点を取り上げます。これは、API がどのように進化し、改善されてきたかを明確に把握できるようにすることを目的としています。
v210 プラットフォーム リリースの更新
v210 プラットフォーム リリースでは、LogicMonitor REST API v3 Swagger、v3 Python、および GO SDK ファイルが次の新しいエンドポイントで更新されました。
カテゴリー | エンドポイント | 目的 |
構成ソース | PATCH/設定/configsources/{id} | ID による ConfigSource の更新 |
GET/設定/configsources/{id} | IDでConfigSourceを取得する | |
/setting/configsources/{id} を削除します | ID による ConfigSource の削除 | |
PUT/setting/configsources/{id} | ID による ConfigSource の更新 | |
POST/設定/configsources | ConfigSource を追加 | |
GET/設定/構成ソース | ConfigSource リストを取得する | |
イベントソース | POST /setting/イベントソース | イベントソースを追加 |
/setting/eventsources/{id} にパッチを適用します | ID による EventSource の更新 | |
GET /setting/eventsources/{id} | ID で EventSource を取得する | |
/setting/eventsources/{id} を削除します | ID によるイベント ソースの削除 | |
PUT /setting/eventsources/{id} | ID による EventSource の更新 | |
ジョブモニター | /setting/batchjobs/{id} にパッチを適用する | ジョブモニターの更新 |
GET /setting/batchjobs/{id} | IDでJobMonitorを取得する | |
DELETE /setting/batchjobs/{id} | ジョブモニターを削除する | |
PUT /setting/batchjobs/{id} | ジョブモニターの更新 | |
POST /setting/batchjobs | ジョブモニターを追加 | |
GET /setting/batchjobs | JobMonitorリストを取得する | |
OID | /setting/oids/{id} にパッチを適用する | OIDを更新する |
/setting/oids/{id} を取得します。 | IDでOIDを取得 | |
/setting/oids/{id} を削除します | OIDを削除する | |
/setting/oids/{id} を配置する | OIDを更新する | |
POST /setting/oids | OIDを追加する | |
/setting/oids を取得する | OIDリストを取得 | |
プロパティソース | /setting/propertyrules/{id} にパッチを適用 | プロパティルールを更新する |
GET /setting/propertyrules/{id} | IDでプロパティルールを取得する | |
/setting/propertyrules/{id} を削除します | プロパティルールを削除する | |
PUT /setting/propertyrules/{id} | プロパティルールを更新する | |
POST /setting/propertyrules | プロパティルールを追加する | |
GET /setting/propertyrules | プロパティルールリストを取得する | |
トポロジーソース | /setting/topologysources/{id} にパッチを適用 | TopologySource の更新 |
GET /setting/topologysources/{id} | ID で TopologySource を取得する | |
/setting/topologysources/{id} を削除します | トポロジソースを削除 | |
PUT /setting/topologysources/{id} | TopologySource の更新 | |
POST /setting/topologysources | トポロジソースを追加 | |
GET /setting/topologysources | トポロジソースリストを取得する | |
しきい値 | /device/devices/{deviceId}/devicedatasources/{hdsId}/instances/{instanceId}/alertsettings/{id} を取得します | 特定のデバイス データソース インスタンスのアラート設定のリストを取得します。 |
POST /device/groups/{deviceGroupId}/clusterAlertConf | クラスターアラート設定を追加する | |
/device/groups/{deviceGroupId}/clusterAlertConf を取得します。 | デバイス グループのクラスタ アラート構成のリストを取得します。 | |
/device/groups/{deviceGroupId}/clusterAlertConf/{id} を削除します | クラスターアラート設定を削除する | |
/device/groups/{deviceGroupId}/clusterAlertConf/{id} にパッチを適用します。 | クラスターアラート構成を更新する | |
/device/groups/{deviceGroupId}/clusterAlertConf/{id} を配置します。 | クラスターアラート構成を更新する | |
/device/groups/{deviceGroupId}/clusterAlertConf/{id} を取得します。 | ID によるクラスターアラート構成の取得 | |
Devices | GET /device/devices/{deviceId}/alertsettings | 特定のデバイスのすべてのインスタンスのすべてのしきい値を取得します |
/device/devices/{id}/endpoints を取得します | NetFlowエンドポイントを取得する | |
GET /デバイス/デバイス/{id}/ポート | NetFlowポートを取得する | |
Rescale データ | /device/devices/{deviceId}/devicedatasources/{hdsId}/instances/{instanceId}/config/{id} を取得します | デバイスの構成を取得する |
v207 プラットフォーム リリースの更新
v207プラットフォームリリースでは、LogicMonitor REST API v3 Swaggerを次のように更新しました。 accessGroups
と accessGroupIds
フィールド。次の API エンドポイントの応答でフィールドを見つけることができます。
関数に適用
GET /setting/functions
GET /setting/functions/{id}
データソース
GET /setting/datasources
GET /setting/datasources/{id}
種類 | 説明 | |
createdBy | String | (読み取り専用) アクセス グループを作成したユーザーの名前。 |
name | String | (必須) アクセスグループの名前。例: LinuxGroup |
tenantId | String | テナントの ID とテナントの詳細。 |
description | String | アクセス グループの説明。 |
id | 整数 | (読み取り専用) アクセス グループの ID。 |
updatedOn | 整数 | (読み取り専用) アクセス グループが更新された時刻。 |
createdOn | 整数 | (読み取り専用) アクセス グループが作成された時刻。 |
accessGroupId | 整数 | アクセス グループの ID。 |
v201 プラットフォーム リリースの更新
プラットフォーム リリース v201 以降、既存のフィルターに加えて _all~
新しいフィルターを使用することもできます description~
特定のデータを検索します。
_all
– フィルタは全文検索、つまり以下に基づいたキーワード検索を実行します。username
,ip
,description
,sessionid
田畑。応答は、前述のフィールド全体でフィルターに指定された値と一致する結果をフェッチします。一般的な結果が得られることに注意してください。
例–{{url}}/setting/accesslogs?filter=_all~"update value=false, old value=true"
ここで、応答は次のようになります。"update value=false, old value=true"
"update value=true, old value=false"
- ある応答はすべて、
update
,value
,false
,old
,value
,true
その中に(任意の順序で)。例えば、"update value of field is changed to true, field old value was false"
description
– フィルターは完全なテキスト検索、つまり完全な部分文字列一致を実行します。検索は、description
分野。応答は、パラメータで指定された値と完全に一致する結果を取得します。description
分野。限定的ではあるが具体的な結果が得られます。
例–{{url}}/setting/accesslogs?filter=description~"update value=false, old value=true"
ここで、応答は次のようになります。"update value=false, old value=true"
v200 プラットフォーム リリースの更新
v200 プラットフォーム リリースでは、次のフィールドを使用して LogicMonitor REST API v3 Swagger を更新しました。
- インスタンスレベルのしきい値設定 –
alertTransitionInterval
,alertClearInterval
,alertForNoData
- インスタンスグループレベルのしきい値設定 –
alertTransitionInterval
,alertClearTransitionInterval
,alertForNoData
- リソースグループレベルのしきい値の設定 –
alertTransitionInterval
,alertClearTransitionInterval
,alertForNoData
影響を受ける API エンドポイントは次のとおりです。
- GET
/device/devices/{deviceId}/devicedatasources/{hdsId}/instances/{instanceId}/alertsettings
- PUT
/device/devices/{deviceId}/devicedatasources/{hdsId}/instances/{instanceId}/alertsettings/{id}
- PATCH
/device/devices/{deviceId}/devicedatasources/{hdsId}/instances/{instanceId}/alertsettings/{id}
- GET
/device/groups/{deviceGroupId}/datasources/{dsId}/alertsettings
- PUT
/device/groups/{deviceGroupId}/datasources/{dsId}/alertsettings
- PATCH
/device/groups/{deviceGroupId}/datasources/{dsId}/alertsettings
- PUT
/device/devices/{deviceId}/devicedatasources/{deviceDsId}/groups/{dsigId}/datapoints/{dpId}/alertconfig
- PATCH
/device/devices/{deviceId}/devicedatasources/{deviceDsId}/groups/{dsigId}/datapoints/{dpId}/alertconfig
v198 プラットフォーム リリースの更新
Swagger および SDK ファイルの更新
v198 プラットフォーム リリースでは、LogicMonitor REST API v3 Swagger、v3 Python、GO SDK ファイルを更新しました。 Swagger および SDK ファイルは、v198 の実稼働環境へのデプロイが完了した後に使用できるようになります。ご質問がある場合は、LogicMonitor カスタマー サクセス マネージャーにお問い合わせください。詳細については、を参照してください。 REST API v3 Swagger ドキュメント.
LogicMonitor REST API v3 に追加された新しい API エンドポイントについては、次の表を参照してください。
カテゴリー | Endpoints | 目的 |
デバイスグループ | POST /azure/functions/discoverSubscriptions POST /azure/functions/testAccount GET /aws/accountId POST /aws/functions/testAccount POST /saas/functions/testAccount POST /gcp/functions/testAccount | サブスクリプション ID を表示する Azure アカウントのテスト AWS アカウント ID を取得する AWS アカウントをテストする SaaS アカウントのテスト GCP アカウントをテストする |
レポート | GET /report/reports/{id}/tasks/{taskId} | レポートを実行する |
ユーザデータ | PATCH /setting/userdata/{id} PUT /setting/userdata/{id} | デフォルトのダッシュボードを更新する |
構成ソース | GET /setting/configsources/{id}/updatereasons | configSource の更新履歴を取得する |
データソース | POST /setting/datasources PUT /setting/datasources/{id} | データソースの追加 データソースの更新 |
ダッシュボードグループ | POST /dashboard/groups/{id}/asyncclone | ダッシュボードグループを非同期的に追加する |
データソースインスタンス | POST /device/devices/{deviceId}/devicedatasources/{deviceDsId}/groups PUT /device/devices/{deviceId}/devicedatasources/{deviceDsId}/groups/{id} PATCH /device/devices/{deviceId}/devicedatasources/{deviceDsId}/groups/{id} | デバイス データソース インスタンス グループの追加 デバイス データソース インスタンス グループを更新する |
Rescale データ | POST /device/instances/datafetch | デバイス インスタンス データを取得する |
デルタ | GET /device/devices/delta GET /device/devices/delta/{deltaId} | 新しいデルタ ID を持つフィルターに一致するデバイスを取得します デルタ ID を使用してデルタ デバイスを取得する |
LogicMonitor REST API v3 から削除された API エンドポイントについては、次の表を参照してください。
カテゴリー | エンドポイント |
データソース | POST /setting/datasources/{id}/audit |
構成ソース | POST /setting/configsources/{id}/audit |
プロパティソース | POST /setting/propertyrules/{id}/audit |
イベントソース | POST /setting/eventsources/{id}/audit |
Bearer Token を使用した LM REST API v4 へのアクセスのブロック
v198 リリース以降、LogicMonitor REST API v4 外部エンドポイントを使用するための認証にベアラー トークンを使用できなくなります。 API v1 を使用するために、Basic 認証と LMv4 認証はすでに無効になっています。 API v4 は正式にサポートされていないことに注意してください。 LogicMonitor REST API v3 の使用をお勧めします。
Python および GO SDK のベアラー トークンのサポート
Bearer トークンを使用して、GO および Python v3 SDK を使用するための自分自身を認証できるようになりました。 SDK ファイルは、v198 の実稼働環境へのデプロイが完了した後に利用できるようになります。ご質問がある場合は、LogicMonitor カスタマー サクセス マネージャーにお問い合わせください。詳細については、を参照してください。 LogicMonitor v3 SDK.
追加の更新
- パフォーマンスの問題のため、削除されました
customColumn
from/alert/alerts
と/alert/alerts/id
応答。同様に、こちらも削除しましたdetailMessage
from/alert/alerts
応答。ただし、ユーザーは引き続き見ることができますdetailMessage
in/alert/alerts/id
応答。 - 更新中
deviceType
デバイスモデルの説明。 deviceType フィールドの値は「0」に設定されます。 - パフォーマンスの問題のため、削除されました
customColumn
からのリクエストパラメータGET /alert/alerts/{id}
とGET /alert/alerts
一般的な変更
REST API v1 および v2 のサポート終了のお知らせ
LogicMonitor REST API v1 および v2 を廃止することを決定しました。 3 年 2023 月から API v1 に移行することをお勧めします。API v2 と v2024 は 3 年 XNUMX 月まで引き続きサポートされ、その後はサポートが停止されます。 API vXNUMX への移行を支援するために、サポート終了日を事前にお知らせします。 詳細については、を参照してください。 LogicMonitor REST API v1 および v2 の廃止.
REST API フィルター
エンドポイントGETを呼び出すと /alert/alerts
フィルターを使用すると、以前は、新しいアラートがなくても、結果が一貫せず、シャッフルされていました。 この問題は修正されました。 新しいアラートが生成されたり、既存のアラートがクリアされたりしない限り、結果はシャッフルされず、アラート リストの順序は一貫したままです。 詳細については、を参照してください。 REST API 基本フィルター と REST API 高度なフィルター.
LMv1 トークン
アプリケーションは、API と SDK を使用して複数のバックエンド プラットフォームに接続し、バックエンド プラットフォームで API と SDK を認証するためのトークン/シークレットを提供します。 認証するために、ユーザーは多くの場合、セキュリティ上の重大な問題につながるソース コードと一緒にシークレット/トークンを入力します。 セキュリティ対策として、トークンのフォーマットを改訂しました。
LMv1 トークンは、access_id+access_key+payload+time+http_method を使用して動的に構築されます。 10 分間しか有効ではないため、リポジトリに保存したりコミットしたりしても意味がありません。
- access_id – サイズ 20 の英数字で構成されます。たとえば、
32WDPj2KIdZikg7g98SR
- access_key – サイズ 120 の英数字で構成されます。たとえば、
lma_A4S8)Ps9^jT9[4YFN4S36yG~+uF[h4tG){]]827McL=E3RtaqED%+{(n2p%+LOTRhYjc3ZmQtNmI2MC00M2EzLWJlZjYtMGQ3MmVhOTEwYzA3L0BeLhN
REST APIv3での変更
numOfKuberntesDevices フィールドの追加
追加しました Kuberntes デバイスの数 フィールドを DeviceGroup
API モデル。 を参照するすべてのエンドポイントの応答本文に存在します。 DeviceGroup
API モデル。 ターゲット グループ内の Kubernetes リソースの数を示します。 また、ターゲット グループのサブ グループ内の Kubernetes リソースの数も含まれます。
例:
HTTPメソッド | APIレスポンス |
GET PUT PATCH | サンタバ/休息/デバイス/グループ/{id} |
POST GET | サンタバ/休息/デバイス/グループ |
選択した場合:
- ルート グループ (id = 1) – 応答本文には、ポータルに存在するすべての Kubernetes デバイスの数が含まれます。
- 特定のデバイス グループ – 応答本文には、そのデバイス グループに存在する Kubernetes デバイスの数が含まれます。
新しいエンドポイント
REST API v3 の主なハイライトは、XNUMX つの新しいエンドポイントの追加です。 彼らです:
- POST – /setting/datasources/{id}/audit
- POST – /setting/evensources/{id}/audit
- POST – /setting/configsources/{id}/audit
- POST – /setting/propertyrules/{id}/audit
- GET – /setting/integrations/auditlogs
詳細については、を参照してください。 REST API v3 Swagger ドキュメント.
REST APIv2での変更
LogicMonitor REST API v2 には、非下位互換性などの新機能が含まれています。
ステータスコード
REST API v1 では、応答に 200 つの状態コードがありました。HTTP 状態コード (ほとんど常に 2) と、応答本文の別の LogicMonitor 状態コードです。 REST API vXNUMX では、HTTP ステータス コードを XNUMX つ返すようになり、返される可能性のあるステータス コードのリストを大幅に絞り込みました。
基本認証のサポートなし
REST API v2 での基本認証のサポートを削除しました。 多くの追加の利点 (UI/API アクセスの分離、監査ログ エントリ、およびより安全) があるため、認証のための API トークンのより多くの使用を促進するためにこれを行いました。
PATCH メソッドのサポート
REST API v2 には、ほとんどのリソースに対する HTTP PATCH のサポートが含まれています。 これは、PUT を使用してリソース全体 (すべてのフィールド) を更新するのではなく、リソースの XNUMX つのフィールドのみを更新する場合に便利です。
レスポンスボディ構造
REST API v1 では、成功した応答が含まれていました status, エラーメッセージ, データ 応答のトップ レベルのオブジェクト。 REST API v2 では、HTTP ステータスが LM ステータスと一致するようになったため、成功応答の最上位で「data」の内容が返されます。 失敗した応答には、エラー メッセージ フィールドが含まれます。 これは、REST API v1 用に作成され、API 応答を解析するように構成されたスクリプトを、これを反映するように調整する必要があることを意味することに注意してください。