未加工の課金データの取得

検出されたソフトウェア関する情報を取得するには、api/sam/v2/software_instances API を使用します。

始める前に

API 出力をプレビューするときに limit パラメーターを使用する

テスト目的で api/sam/raw_app_usage_property_values API を使用する場合は、応答時間を短縮するために limit パラメーターを追加します。最初の 100 レコードで、利用可能なデータを表示するのに十分である必要があります。

https://hostname:port/api/sam/raw_app_usage_property_values?token=token&limit=100

注: 各 API 要求は、token パラメーターを使用して認証する必要があります。これは、認証トークンを取得するための REST API を使用して取得できます。BigFix Inventory にログインして「ユーザー」アイコン にカーソルを移動して、「プロファイル」をクリックすることもできます。次に、「トークンの表示」をクリックします。

照会パラメーター

URL?columns[]=name&columns[]=computer_id

URL?order[]=name desc

URL?limit=50&offset=150

<criteria> ::= <left-brace> <boolean-operator><colon> <left-bracket> 
<criterion> [{ <comma> <criterion> }...] <right-bracket> <right-brace>

<boolean-operator> ::= "and" | "or"
<criterion> ::= <criteria> | <left-bracket> <column> <comma> <operator> <comma> <value> <right-bracket>
<column> ::= <json-string>
<operator> ::= <json-string>
<value> 	::= <json-array> | <json-string> | <json-numver> | <json-null>

URL?criteria={ "and": [ ["computer_id", ">", "10"]]}

URL?criteria={"and":[["last_seen","last","P7D"]]}

HTTP 会話の例

要求

GET api/sam/raw_app_usage_property_values
?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
Host: localhost:9081 
Accept: application/json 
Accept-Language: en-US

応答ヘッダー

HTTP/1.1 200 OK
Content-Type: application/json
Content-Language: en-US

応答の本文 (JSON)

 {
  "app_usage_property_id": -1,  
  "computer_id": 2,
  "process": "BESClient.exe",
  "first_used": "2015-03-27T16:28:47Z",
  "last_used": "2015-08-03T11:46:16Z",
  "total_runs": 5,
  "total_time": 10888494,
  "avg_runs_per_day": 0.03943099252280677,
  "avg_run_time": 2177698.8,
  "valid_from": "2015-08-05T14:41:19Z",
  "valid_to": "9999-12-31T23:59:59Z" 
 }
 {
  "app_usage_property_id": -1,
  "computer_id": 2,
  "process": "BESConsole.exe",
  "first_used": "2015-07-09T11:27:50Z",
  "last_used": "2015-07-13T13:33:42Z",
  "total_runs": 2,
  "total_time": 16767,
  "avg_runs_per_day": 0.4893077201884741,
  "avg_run_time": 8383.5,
  "valid_from": "2015-08-05T14:41:19Z",
  "valid_to": "9999-12-31T23:59:59Z"  
 }