未加工の UNIX パッケージ・データの取得

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

始める前に

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

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

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

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

選択可能な列

表 2. 選択可能な列

列	「説明」	デフォルトで表示	タイプ
is_suppressed	パッケージが抑止されることを示します。パッケージが抑止されると、列の値は 1 になります。パッケージが抑止されない場合、値は 0 です。		ブール値
comment	抑止についてコメントします。		string
unix_package_property_id	UNIX パッケージ・プロパティーの識別子。	✓	数字
version_id	パッケージの内部バージョン識別子。		数字
type	パッケージ・データのタイプ。	✓	string
index_sha1	パッケージ sha1 チェックサム	✓	string
computer_id	BigFix Inventory で定義されているコンピューターの ID。	✓	数字
description	パッケージの説明。	✓	ストリング
name	パッケージに名前を付けます。	✓	ストリング
version	パッケージのバージョン。	✓	ストリング
vendor	パッケージのベンダー。	✓	ストリング
valid_from	パッケージが初めてレポートされた日時。時間は、GMT タイム・ゾーンで示されます。	✓	ストリング
valid_to	パッケージが最後にレポートされた日時。時間は、GMT タイム・ゾーンで示されます。	✓	ストリング

照会パラメーター

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_unix_package_facts
?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)

 {
  "unix_package_property_id": -1,
  "computer_id": 14,
  "name": "lohit-oriya-fonts",
  "version": "2.4.3-6.el6",
  "vendor": "Red Hat, Inc.",
  "description": null,
  "type": "Rpm",
  "index_sha1": "176d82d8994b5c7b27f5ba8446cb40a802b2e8f5",
  "valid_from": "2016-02-29T15:33:10Z",
  "valid_to": "9999-12-31T23:59:59Z"
 }
 {
  "unix_package_property_id": -1,
  "computer_id": 14,
  "name": "libcollection",
  "version": "0.6.0-9.el6",
  "vendor": "Red Hat, Inc.",
  "description": null,
  "type": "Rpm",
  "index_sha1": "69ac3e6fc5674c4feb1c90aae88975d9d0ebe615",
  "valid_from": "2016-02-29T15:33:10Z",
  "valid_to": "9999-12-31T23:59:59Z"
 }