LogicMonitorのRESTAPIを使用する
最終更新日: 19 年 2024 月 XNUMX 日すべての更新と拡張は、LogicMonitor REST API v3 のみに対して行われます。 一歩先を行くために、最新の v3 に切り替えることを強くお勧めします。
LogicMonitor REST APIを使用すると、ダッシュボード、デバイス、レポート、サービス、アラート、コレクター、データソース、SDTなどのLogicMonitorリソースをプログラムでクエリおよび管理できます。
ベースURL
RESTAPIリクエストを行うためのベースURLは次のとおりです。
https://ACCOUNTNAME.logicmonitor.com/santaba/restここで、交換する必要があります ACCOUNTNAME を LogicMonitor アカウント名に置き換えます。
サポートされている API バージョン
LogicMonitor REST API は、v3、v2、および v1 の XNUMX つのバージョンで利用できます。 使用するバージョンを決定するには、次のガイドラインを考慮する必要があります。
- 私たちはフォローする セマンティックバージョニング、ただし、リクエストではメジャー バージョンのみが許可されます (最新のマイナー バージョンまたはパッチ バージョンが常に返されます)
- すべての更新と機能強化はバージョン 3 に対して行われます たったの.
- バージョンは、X-Version ヘッダーで指定するか、クエリ パラメーターとして URL で指定できます。 「?v=3」クエリ パラメータまたは「X-Version:3」ヘッダーを含めることによって、v3 リクエストを行うことができます。
最新の v3 API にアクセスするには、次を参照してください。 v3 Swagger ドキュメント.
認証
LogicMonitorサーバーに送信される各要求は、 HTTPS, and must also be authenticated. All data is received as JSON. LogicMonitor REST API currently supports three authentication methods:
- ベアラートークン
- LMv1
- 基本認証
注： Basic Authentication is only supported in v1 of the API, and may not be available with future versions of the API. Therefore, we highly recommend that you make REST API requests with API token based authentication (LMv1 and Bearer token).
詳細については、を参照してください。 RESTAPI認証.
レート制限
LogicMonitor REST API へのリクエストには、レート制限が適用されます。 制限は、エンドポイントとメソッドの組み合わせによって異なります。 デフォルトのレート制限のリスト、レスポンス ヘッダーからレート制限情報を取得する方法の詳細、およびレート制限に対応するようにスクリプトを調整する方法の複数言語の例については、次を参照してください。 REST API レート制限.
ステータス コードとエラー コード
ロールアウトした API バージョンごとに、ステータス コードとエラー コードを進化させ、改善してきました。 リストにアクセスするには、を参照してください。 ステータスコード & エラーコード.
変更ログ
LogicMonitor REST API は常に進化しています。 API に対して行われたすべての更新を追跡するには、次を参照してください。 変更ログ.
サポートされている HTTP メソッド
LogicMonitor REST API は、グローバルに使用される HTTP 動詞またはメソッドを使用します。 それらは、POST、GET、PUT、PATCH、および DELETE です。 これらのメソッドは、それぞれ Create、Read/Retrieve、Update、および Delete (別名 CRUD) 操作に対応しています。
- POST– 通常、POST API は、新しい従属リソースを作成するために使用されます。 LogicMonitor REST API は POST メソッドを使用して、API トークン、ダッシュボード グループなどを追加します。 たとえば、POST/dashboard/groups と POST/setting/alert/chains です。
- GET– GET リクエストを使用して、リソース情報を読み取り/取得します。 GET メソッドを使用して、リソースのコンテンツとデータの表現を取得できます。 たとえば、GET/alert/alerts/{id} および GET/dashboard/groups/{id} です。
- PUT– PUT メソッドを使用して、コンテンツを完全に置き換えてリソースを更新します。 REST 標準に準拠して、PUT 要求で指定されていないプロパティはすべてデフォルト値に戻ります。 PUT リクエストの例は、PUT/setting/alert/chains/{id} および PUT/setting/recipientgroups/{id} です。
- PATCH– PATCH メソッドを使用して、リソース コンテンツを更新/変更します。 PATCH リクエストでは、リソースに加えたい更新を指定する必要があります。 たとえば、PATCH/report/reports/{id} および PATCH/setting/roles/{id} です。
- DELETE– DELETE メソッドを使用して、URI で識別されるリソースを削除します。 リソースは完全に削除されます。 たとえば、DELETE/sdt/sdts/{id} および DELETE/setting/recipientgroups/{id} です。
ロジックモニターSDK
REST API に加えて、LogicMonitor は Python および GO SDK もサポートします。 GO および Python SDK を使用する前に、自分自身を認証する必要があります。自分自身を認証するには、LMv1Auth または Bearer トークンを使用できます。ダウンロード可能な v3 SDK ファイルを入手するには、次を参照してください。 LogicMonitor v3 SDK.