SMBIOS に関連する情報の取得 (v2)

9.2.12 9.2.12 から使用可能です。api/sam/v2/detailed_hw_smbios エレメントに対して GET 操作を使用して、スキャンされたシステム上の SMBIOS に関連する情報を要求します。

権限

ユーザー この API を使用するには、「エンドポイントの表示」権限および「ハードウェア・インベントリーの表示」権限が必要です。

リソース URL

https://hostname:port/api/sam/v2/detailed_hw_smbios?token=token

リソース情報

表 1. リソース情報
操作の詳細 「説明」
HTTP メソッド GET
要求ヘッダー
ヘッダー
Accept-Language (オプション)
値
en-US (英語のみをサポート)

応答の言語をネゴシエーションします。ヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。
要求フォーマット application/json
応答ヘッダー
ヘッダー
Content-Type
値
application/json

応答のコンテンツ・タイプを指定します。
ヘッダー
Content-Language
値
en-US, …

応答のコンテンツの言語を指定します。ヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。
応答ペイロード SMBIOS element
応答フォーマット application/json
応答コード

200 – OK

500 – "Bad Request" 照会パラメーターにエラーがあるか、照会パラメーターが欠落している場合

スキーマの説明

この REST API によって返されるすべての列のリストをその説明と一緒に取得するには、次の要求を使用します。
GET api/sam/v2/schemas/detailed_hw_smbios.json?token=token

選択可能な列

スキャンされたシステムの SMBIOS に関連する属性のリスト。

スキャン出力には、このグループの各属性の単一のインスタンスが含まれます。

表 2. SMBIOS に関する情報が含まれる列
プロパティー 説明\n タイプ
ID レコードの ID。 Integer
computer_id BigFix Inventory データベースで指定されているコンピューターの ID Integer
updated_at 現在の情報が BigFix Inventory にインポートされた日時。 ストリング
Linux Windows bios_vendor BIOS システムの製造メーカー。 ストリング
Linux Windows bios_vendor BIOS システムのバージョン。 ストリング
Linux system_version システムのバージョン。 ストリング
Linux Windows system_serial_number システムのシリアル番号。 ストリング

関連 API

この API は、以下の API に関連付けることができます:

照会パラメーター

表 3. 照会パラメーター
パラメーター 「説明」 必須 値
columns[] 取得する列を指定します。このパラメーターを指定しなかった場合、デフォルトの列のみが取得されます。
例: コンピューター ID の取得:
URL?columns[]=computer_id
 ストリング
order 返されたデータのソート方法を指定します。列のソートのデフォルト方向は昇順です。降順ソートを指定する場合は、列名に desc を追加します。
例: コンピューター ID の降順での並び替え:
URL?order[]=computer_id desc
 ストリング
限界値 取得する行数を指定します。このパラメーターを省略した場合、すべての行が取得されます。
例: 100 件のレコードの取得 
URL?limit=100
注: デフォルトでは、この API の limit パラメーターは 100000 に設定されています。
 数字
offset 結果の取得でスキップする行数を指定します。これを limit パラメーターと一緒に使用して、結果をページ編集できます。
例: レコード 150 の後から始まる 50 件のレコードの取得
URL?limit=50&offset=150
 数字
token 固有のユーザー認証 ID。認証トークンを取得するための REST API を使用して取得することができます。BigFix Inventory にログインして「ユーザー」アイコン「ユーザー」アイコンにカーソルを移動して、「プロファイル」をクリックすることもできます。次に、「トークンの表示」をクリックします。 ✓ 英数字
criteria 特定の条件と合致するレコードを取得します。このパラメーターでは、以下の構造が 1 行で記述されている必要があります。 
<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>

演算子について詳しくは、以下を参照してください。「共通のコネクターおよび演算子」。

例: コンピューター ID が1000より大きいコンピューターの取得。
URL?criteria={"and":[["computer_id", ">", "1000"]]}

日時の値を使用する列の場合、特定の日付の代わりにある期間のデータを取得することもできます。これを行うには、last または next を <operator> として使用し、次の規則で時刻の値を指定します。PxD/PxW/PxM/PxY。ここで、x は 1 から 999 の範囲の数値であり、D、W、M、Y はそれぞれ、日、週、月、年を表す指定子です。

ストリング

会話例 - デフォルトの列

要求
GET api/sam/v2/detailed_hw_smbios?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
Host: localhost:9081 
Accept: application/json 
Accept-Language: en-US
応答本文
[{
"id":12,
"computer_id":19,
"updated_at":"2018-05-28T01:22:16Z",
"bios_vendor":"Phoenix Technologies LTD",
"bios_version":"6.00",
"system_version":"None",
"system_serial_number":"VMware-42 14 ea ea 03 c0 d5 03-fd f6 43 d6 44 a2 f8 52"
}]

会話例 - 選択された列

要求 
GET api/sam/v2/detailed_hw_smbios?columns[]=computer_id
&columns[]=bios_vendor&columns[]=bios_version
&token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
Host: localhost:9081 
Accept: application/json 
Accept-Language: en-US
応答本文
[{
"computer_id":19,
"bios_vendor":"Phoenix Technologies LTD",
"bios_version":"6.00"
}]