サポートセンターホーム


デバイスのプロパティを取得する

LogicMonitorのRESTAPIを使用して、カスタムかシステムか、継承されているかどうかに関係なく、デバイスのすべてのプロパティを取得できます。 プロパティ情報を取得するには、次のXNUMXつの方法があります。

  1. デバイスのすべてのプロパティを取得する
  2. 特定のデバイスプロパティに関する情報を取得する

注:すべてのAPI呼び出しと同様に、 認証が必要です.

すべてのデバイスプロパティを取得する

HTTPメソッド:GET

リソースURI:/ device / devices / {deviceID} / properties

ここで、deviceIDは、プロパティを取得するデバイスのIDであり、から取得できます。 デバイスリソース.

リソースのプロパティ:

リクエストパラメータ: デフォルトでは、50個のデバイスプロパティのリストが返されます。 リクエストに並べ替え、フィルター、フィールド、サイズ、オフセットのパラメーターを含めて、応答に含まれるデータとそのフォーマット方法を制御できます。 クエリパラメータはリソースパスの一部とは見なされないため、LMv1認証署名の計算に含めるべきではないことに注意してください。

プロパティ

構文

製品説明

URIの例

sort sort = {+または-} property 昇順(+)または降順(-)のいずれかで指定されたプロパティで応答を並べ替えます / device / devices / 12 / properties?sort = -type
filter filter = property {operator} value 指定された演算子と値に従って応答をフィルタリングします。 *を使用して複数の文字に一致させることができることに注意してください。 '。'を使用できますオブジェクト内の値(カスタムプロパティなど)をフィルタリングする文字。複数のフィルターはコンマで区切ることができます。

 

演算子は次のとおりです。

  • 以上: >:
  • 以下: <:
  • 大なり記号: >
  • 未満: <
  • 等しくない: !:
  • 等しい: :
  • 含まれています: ~
  • 含まれていません: !~
/ device / devices / 45 / properties?filter = name〜QA *
フィールド fields = {コンマで区切られたプロパティのリスト} 応答をフィルタリングして、各オブジェクトの次のフィールドのみを含めます / device / devices / 89 / properties?fields = name、id
サイズ size = integer 表示する結果の数。 最大は1000です。 / device / devices / 65 / properties?size = 5
オフセット offset = integer 表示された結果を相殺する結果の数 / device / devices / 76 / properties?offset = 2

特定のデバイスプロパティに関する情報を取得する

HTTPメソッド:GET

リソースURI:/ device / devices / {deviceID} / properties / {propertyName}

ここで、deviceIDは、プロパティを取得するデバイスのIDであり、から取得できます。 デバイスリソース。 propertyNameは、情報を取得するプロパティの名前であり、そこから取得できます。 すべてのデバイスプロパティを取得する.

例1

次のPythonスクリプトは、デバイス4374のすべてのプロパティを取得します。

#!/bin/env python

import requests
import json
import hashlib
import base64
import time
import hmac

#Account Info
AccessId ='your-access-id'
AccessKey ='your-access-key'
Company = 'api'

##Request Info
httpVerb ='GET'
resourcePath = '/device/devices/4374/properties'
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)
Pythonの3

例2

次のPythonスクリプトは、「proddc」という名前のプロパティに関する情報を取得します。

#!/bin/env python

import requests
import json
import hashlib
import base64
import time
import hmac

#Account Info
AccessId ='your-access-id'
AccessKey ='your-access-key'
Company = 'api'

##Request Info
httpVerb ='GET'
resourcePath = '/device/devices/4374/properties/proddc'
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)
Pythonの3

記事上で