製品ドキュメント

デバイスグループを取得する

最終更新日: 24 年 2021 月 XNUMX 日

LogicMonitorのRESTAPIを使用して、LogicMonitorデバイスグループに関する情報をプログラムで取得できます。 デバイスグループのリストを取得することも、特定のデバイスグループの詳細を取得することもできます。

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

デバイスグループのリストを取得する

デバイスグループのリストを返します

HTTPメソッド：GET

URI：/ device / groups

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

プロパティ

構文

商品説明

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

 

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

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

特定のデバイスグループに関する情報を取得する

特定のデバイスグループの詳細を返します

HTTPメソッド：GET

URI：デバイス/グループ/ {id}

リクエストパラメータ： 応答に表示されるフィールドを制御するフィルターパラメーターを含めることができます。

プロパティ

構文

商品説明

URIの例
フィールド fields = {コンマで区切られたプロパティのリスト} 応答をフィルタリングして、各オブジェクトの次のフィールドのみを含めます / device / groups / {id}？fields = name、id、subGroups

例

次のPythonスクリプトは、名前に「prodServers」が含まれるデバイスグループのカスタムプロパティ、名前、ID、およびデバイスの数を返します。

#!/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/groups'
queryParams = '?filter=name~prodServers&fields=customProperties,id,name,numOfHosts'
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

#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
記事上で