データソースインスタンスを取得する
最終更新日: 29 年 2022 月 XNUMX 日LogicMonitorのRESTAPIを使用して、データソースのインスタンスをプログラムで取得できます。
注:すべてのAPI呼び出しと同様に、 認証が必要です.
データソースインスタンスのリストを取得する
HTTPメソッド:GET
URI:/ device / devices / {deviceId} / devicedatasources / {deviceDatasourceId} / instances
どこ:
- {deviceId}は、GETリクエストから取得できるデバイスIDです。 デバイスリソース
- {deviceDatasourceId}は、デバイスデータソースIDであり、GETリクエストから デバイスデータソースリソース
リクエストパラメータ: デフォルトでは、50個のインスタンスのリストが返されます。 リクエストに並べ替え、フィルター、フィールド、サイズ、オフセットのパラメーターを含めて、応答に含まれるデータとそのフォーマット方法を制御できます。
プロパティ |
構文 |
説明 |
URIの例 |
sort | sort = {+または-} property | 昇順(+)または降順(-)のいずれかで指定されたプロパティで応答を並べ替えます | / device / devices / 12 / devicedatasources / 98 / instances?sort = -id |
filter | filter = property {operator} value | 指定された演算子と値に従って応答をフィルタリングします。 *を使用して複数の文字に一致させることができることに注意してください。 '。'を使用できますオブジェクト内の値(カスタムプロパティなど)をフィルタリングする文字。複数のフィルターはコンマで区切ることができます。
演算子は次のとおりです。
|
/ device / devices / 43 / devicedatasources / 76 / instance?filter = name〜prod43 * |
フィールド | fields = {コンマで区切られたプロパティのリスト} | 応答をフィルタリングして、各オブジェクトの次のフィールドのみを含めます | / device / devices / 9 / devicedatasources / 24 / instances?fields = name、id |
サイズ | size = integer | 表示する結果の数。 最大は1000です。 | / device / devices / 87 / devicedatasources / 54 / instances?size = 5 |
オフセット | offset = integer | 表示された結果を相殺する結果の数 | / device / devices / 34 / devicedatasources / 90 / instances?offset = 2 |
例
次のPythonスクリプトは、デバイス533、デバイスデータソース10256のすべてのインスタンスを返します。
#!/bin/env python
import requests
import json
import hashlib
import base64
import time
import hmac
#Account Info
AccessId ='48v2wRzfK94y53sq5EuF'
AccessKey ='H_D9i(f5~B^U36^K6i42=^nS~e75gy382Bf6{)P+'
Company = 'api'
#Request Info
httpVerb ='GET'
resourcePath = '/device/devices/533/devicedatasources/10256/instances'
queryParams = ''
data = ''
#Construct URL
url = 'https://'+ Company +'.logicmonitor.com/santaba/rest' + resourcePath +queryParams
#Get current time in milliseconds
epoch = str(int(time.time() * 1000))
#Concatenate Request details
requestVars = httpVerb + epoch + data + resourcePath
#Construct signature
hmac1 = hmac.new(AccessKey.encode(),msg=requestVars.encode(),digestmod=hashlib.sha256).hexdigest()
signature = base64.b64encode(hmac1.encode())
#Construct headers
auth = 'LMv1 ' + AccessId + ':' + signature.decode() + ':' + epoch
headers = {'Content-Type':'application/json','Authorization':auth}
#Make request
response = requests.get(url, data=data, headers=headers)
#Print status and body of response
print('Response Status:',response.status_code)
print('Response Body:',response.content)
特定のデータソースインスタンスに関する情報を取得する
HTTPメソッド:GET
URI:/ device / devices / {deviceId} / devicedatasources / {deviceDatasourceId} / instances / {instanceId}
どこ:
- {deviceId}は、GETリクエストから取得できるデバイスIDです。 デバイスリソース
- {deviceDatasourceId}は、デバイスデータソースIDであり、GETリクエストから デバイスデータソースリソース
- {instanceId}はインスタンスIDです
リクエストパラメータ: リクエストにfieldsパラメータを含めて、レスポンスに含まれるデータとそのフォーマット方法を制御できます。
プロパティ |
構文 |
説明 |
URIの例 |
フィールド | fields = {コンマで区切られたプロパティのリスト} | 応答をフィルタリングして、各オブジェクトの次のフィールドのみを含めます | / device / devices / 9 / devicedatasources / 24 / instances / 45?fields = name、id |
例
次のPythonスクリプトは、デバイス533、デバイスデータソース10256、インスタンス23のすべてのインスタンスを返します。
#!/bin/env python
import requests
import json
import hashlib
import base64
import time
import hmac
#Account Info
AccessId ='48v2wRzfK94y53sq5EuF'
AccessKey ='H_D9i(f5~B^U36^K6i42=^nS~e75gy382Bf6{)P+'
Company = 'api'
#Request Info
httpVerb ='GET'
resourcePath = '/device/devices/533/devicedatasources/10256/instances/23'
queryParams = ''
data = ''
#Construct URL
url = 'https://'+ Company +'.logicmonitor.com/santaba/rest' + resourcePath +queryParams
#Get current time in milliseconds
epoch = str(int(time.time() * 1000))
#Concatenate Request details
requestVars = httpVerb + epoch + data + resourcePath
#Construct signature
hmac1 = hmac.new(AccessKey.encode(),msg=requestVars.encode(),digestmod=hashlib.sha256).hexdigest()
signature = base64.b64encode(hmac1.encode())
#Construct headers
auth = 'LMv1 ' + AccessId + ':' + signature.decode() + ':' + epoch
headers = {'Content-Type':'application/json','Authorization':auth}
#Make request
response = requests.get(url, data=data, headers=headers)
#Print status and body of response
print('Response Status:',response.status_code)
print('Response Body:',response.content)