コンピューター・システムの取得

この API は、物理コンピューター・システムおよび仮想コンピューター・システムに関する情報を取得します。BigFix クライアントがインストールされているコンピューターは別として、これにはクライアントがデプロイされていないホスト・システムも含まれています。これは、一部の仮想化タイプ (VMware ESXi や IBM PowerVMなど) では、ホスト・レベルでのソフトウェアのインストールが許可されていないためです。しかし、サーバーとその仮想マシン間の適切な階層を構築し、PVU および RVU 使用量を正しく報告するには、このようなホスト・コンピューター・システムに関連するデータを取得する必要があります。

type プロパティーは、コンピューター・システムがホスト・コンピューターであるのか、仮想コンピューターであるのかを決定します。ホストには、例えば、エージェントがインストールされたラップトップ、ESX ハイパーバイザー、および仮想化サーバーが考えられます。仮想マシンと呼ばれるのは、ホスト上にデプロイ可能な仮想マシンのみです。したがって、REST API の結果は、単一レポート、特にコンピューター・レポートおよびハードウェア・インベントリー・レポートとは比較しないでください。

https://hostname:port/api/sam/computer_systems?token=token

照会パラメーター

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

URL?order[]=type 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={ "or": [ ["os", "contains", "aix"], 
{ "and": [ ["last_seen", ">", "1970-01-01T00:00:00+00:00Z"], 
["last_seen", "<", "1970-01-02T00:00:00+00:00Z"] ] } ] }

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

HTTP 会話の例

要求

GET api/sam/computer_systems
?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

上記の応答ヘッダーの後には、Import-Mode で表わされるデータ・インポートの現在の状況に応じてそれぞれ異なる項目が続きます。返される値について理解するために、以下の定義を確認してください。

• none - データ・インポートが一度も開始されていない
• idle - データ・インポートは現在実行されていない
• running - データ・インポートは進行中
• pending - ユーザー・インターフェースで実行されるアクションが、データ・インポートを開始して変更を有効にすることを必要とする

データ・インポートが一度も開始されていない場合:

Import-Mode: none

データ・インポートが進行中の場合:

Import-Mode: running
Import-Progress: 41

データ・インポートが実行されていない場合:

Import-Mode: idle/pending
Import-Last-Status: successful
Import-Last-Success-Time: Mon, 23 Jun 2014 12:18:29 GMT

応答の本文 (JSON)

特定の項目がデフォルトで非表示になっている場合、一般 URL を使用してもその項目は取得されません。このようなデータを取得するには、照会パラメーターを使用して、非表示の列の名前を指定する必要があります。例えば、以下に示すように、columns[] パラメーターを使用して、server_id 列および datasource_id 列を取得できます。

URL?columns[]=server_id&columns[]=datasource_id

{	
 "id": 25,
 "parent_id"=9,                        //ID of a host for a VM 
 "computer_id": 2,                     //hidden by default
 "computer_remote_id": 123,            //hidden by default
 "server_id": 24,                      //hidden by default
 "datasource_name"="Data source",      //hidden by default
 "datasource_id"=1,                    //hidden by default
 "type"="virtual",                     //type: virtual or host
 "os": "Linux Red Hat Enterprise Server 6.2)",
 "host_name": "NC040221",
 "dns_name": "NC040221.kraklab.pl.ibm.com",
 "ip_address": [
    "9.167.40.221",
    "192.168.122.1" ],
 "last_seen": "2014-04-08T14:33:41Z",
 "hardware_manufacturer": "IBM",
 "hardware_model": "System x3550 M2 -[794662G]-", 
 "hardware_serial_number": "99B7166",
 "hardware_type": "7946",              //hidden by default
 "hardware_name": "IBM Corp. 7946",    //hidden by default
 "processor_brand_string": "Intel(R) Xeon(R) CPU E7-3400 @ 2.40GHz",
 "processor_type": "Multi-core",
 "processor_brand": "Xeon(R)",
 "processor_vendor": "Intel(R)",
 "processor_model": "3400-3699 or 5500-5699",
 "partition_cores" : 1,                //null for host serves
 "server_processors": 1,
 "server_cores": 8,
 "pvu_per_core": 70,                   //hidden by default
 "uuid":"50305bd3-1f09-7294-7033-b903767d4605" //hidden by default
 "cluster_id":"1"                      // hidden by default 
}		//ID of the cluster to which the computer system
 		belongs. Available only for type: host.