物理プロセッサーに関連する情報の取得 (v2)

9.2.12 から使用可能です。api/sam/v2/detailed_hw_physical_processors エレメントに対して GET 操作を使用して、すべてのアクティブな物理プロセッサーに関連する情報を要求します。

権限

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

リソース URL

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

リソース情報

表 1. リソース情報
操作の詳細	「説明」
HTTP メソッド	`GET`
要求ヘッダー	ヘッダー `Accept-Language` (オプション) 値 en-US (英語のみをサポート) 応答の言語をネゴシエーションします。ヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。
要求フォーマット	`application/json`
応答ヘッダー	ヘッダー `Content-Type` 値 `application/json` 応答のコンテンツ・タイプを指定します。
応答ヘッダー	ヘッダー `Content-Language` 値 en-US, … 応答のコンテンツの言語を指定します。ヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。
応答ペイロード	`Physical Processors` element
応答フォーマット	`application/json`
応答コード	`200 – OK` `500 – "Bad Request"` 照会パラメーターにエラーがあるか、照会パラメーターが欠落している場合

スキーマの説明

この REST API によって返されるすべての列のリストをその説明と一緒に取得するには、次の要求を使用します。

GET api/sam/v2/schemas/detailed_hw_physical_processor.json?token=token

選択可能な列

単一のチップおよびプロセッサー・パッケージを含む、すべてのアクティブな物理プロセッサーに関連する属性のリスト。物理プロセッサーごとに 1 つのオペレーティング・システムに変換されるホストとして機能する、各プラットフォームの値を取得することができます。

注: VMware または BigFix LPAR などのゲスト・オペレーティング・システムの物理プロセッサーに関する情報を取得するには、物理マシンの完全な情報が使用可能である必要があります。

スキャン出力には、このグループの各属性の複数のインスタンスが含まれる可能性があります。

表 2. 物理プロセッサーに関する情報が含まれる列
プロパティー	説明\n	タイプ
ID	レコードの ID。	Integer
computer_id	BigFix Inventory データベースで指定されているコンピューターの ID	Integer
updated_at	現在の情報が BigFix Inventory にインポートされた日時。	ストリング
core_per_package_count	物理プロセッサー上のコアの数 (例: Intel Xeon E5-4620 は 8 コア、POWER9 は 12 コア)。	ストリング
logical_proc_per_core	各コアに割り当てられた論理プロセッサーの数 (例: Intel Xeon E5-4620 は 2、POWER9 は 8)。	ストリング
製造メーカー	プロセッサーの製造メーカー (例: Intel、AMD、BigFix)。注: スキャナーでサポートされている製造メーカーに関する情報のみを取得できます。それ以外の場合は、表示される値は「不明」となります。	ストリング
family	プロセッサー・ファミリー (例: Xeon や POWER9)。注: スキャナーでサポートされているプロセッサー・ファミリーに関する情報のみを取得できます。それ以外の場合は、表示される値は「不明」となります。	ストリング
type	プロセッサー・タイプ (例: Intel Xeon E5-4620 の場合は E5-4620)。注: スキャナーがプロセッサー・ファミリーのタイプ ID をサポートしていない場合、値は空になります。スキャナーがプロセッサー・ファミリーのタイプ ID をサポートしているが、指定されたタイプが認識されない場合、表示される値は「不明」となります。	ストリング
cpu_freq	プロセッサー周波数 (メガヘルツ (MHz) 単位)。この情報はオプションであり、ベンダーに固有のものです。プロセッサー・ファミリーによって、この値は公称または現在の CPU 周波数のいずれかを表します。注: CPU の周波数は、プロセッサー・アーキテクチャーおよびファミリーによって異なって解釈される場合があります。この情報が適用できない場合、値は 0 になります。	ストリング
brandname	プロセッサーの名前。この情報はオプションであり、プラットフォームおよびベンダーに固有のものです。したがって、各プラットフォーム、またはプロセッサー・ファミリーの場合でも、別のソースから取得することができます。使用可能な場合、この値は CPUID 命令、BIOS、または OS によって報告される値のコピーとなります。	ストリング
active_processor_count	物理プロセッサー内のアクティブ・プロセッサーの数。物理プロセッサー上で論理プロセッサーが稼働している場合、そのプロセッサーはアクティブです。	ストリング
active_core_count	物理プロセッサー内のアクティブ・コアの数。コアで論理プロセッサが実行されている場合、そのコアはアクティブです。	ストリング

照会パラメーター

表 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_physical_processors?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
Host: localhost:9081 
Accept: application/json 
Accept-Language: en-US

応答本文

[{
"id":7,
"computer_id":4,
"updated_at":"2018-05-30T01:15:05Z",
"core_per_package_count":"1",
"logical_proc_per_core":"1",
"manufacturer":"Intel",
"family":"Xeon",
"type":"E7-8880",
"cpu_freq":"2200",
"brandname":"Intel(R) Xeon(R) CPU E7-8880 v4 @ 2.20GHz","
active_processor_count":"1",
"active_core_count":"1"
}]

会話例 - 選択された列