computer_hardware association

Edit online

9.2.8 Available from 9.2.8.

Use the computer_hardware association to retrieve detailed hardware information as part of other REST API requests.

Association

computer_hardware

Applicable REST APIs

You can use the computer_hardware association with the following REST APIs:

Syntax

<URL>?columns[]=computer_hardware.<column>
For example:
GET https://hostname:port/api/sam/v2/software_instances?columns[]=computer_hardware.computer_type

9.2.10 Schema description

To retrieve the list of all columns that are returned by this association together with their descriptions, use the following request.
GET https://hostname:port/api/sam/schemas/associations/computer_hardware.json

Available columns

Table 1. Columns with information about computer hardware
Property Name on the Hardware Inventory report Description Type
cluster_cores_count Cluster Cores Number of processor cores available within the cluster to which the computer belongs. Numeric
cluster_name Cluster Name Name of the cluster to which the computer belongs. String
computer_type Computer Type Type of the computer. Possible values are:
  • 0 - physical
  • 1- virtual
  • 2- computer running on a public cloud
 Numeric
9.2.24 custom_pvu_per_core Changed PVU Value Specifies whether the number of processor value units for a specific server was manually changed. Possible values are:
  • 0 - false
  • 1- true
 String
default_pvu_value Default PVU Value Indicates whether a default number of processor value units is assigned to the computer. Possible values are:
  • 0 - false
  • 1- true
 String
9.2.24 entitlement LPAR Entitlement Number of processor cores that are assigned to the logical partition. Available only for AIX. For other operating systems, the value of property is null. Numeric
9.2.24 is_capped Is Capped Indicates whether the partition is capped, that is whether its access to processor resources is limited. Available only for AIX. Possible values are:
  • 0 - false
  • 1 - true
  • 2 - no data/undefined
 String
9.2.24 is_shared_type Shared Mode Indicates whether the logical partition works in the shared mode. Available only for AIX. Possible values are:
  • 0 - false
  • 1 - true
  • 2 - no data/undefined
 String
9.2.24 no_processors_pshared_pool Physical Shared Pool Cores Number of processors that work in the shared mode. Numeric
9.2.24 no_processors_shared_pool Virtual Shared Pool Cores Number of active processor cores in the virtual shared pool. Numeric
node_total_processors Server Active Sockets Number of active sockets on the physical server for placing CPU units. Numeric
9.2.24 online_vp_count Partition Virtual Processors Number of virtual processors that are assigned to the partition on which the BigFix® agent is installed. The value is used in further calculations when the endpoint works in the uncapped mode. Available only for AIX. Numeric
partition_cores Partition Cores Number of processor cores on the partition on which the BigFix client is installed. The number does not take into account hyper-threading on the x86 architecture. Numeric
9.2.27 platform N/A Hardware architecture. Possible values are:
  • x86 platforms that are available on Windows, Linux, and SUN:
    • IA32ONWIN64
    • AMD64
    • amd64
    • x86
    • i386
    • i586
    • i686
    • x86_64
  • Power platforms that are available on AIX, IBM i, and Linux:
    • ppc
    • ppc64
    • ppc64le
    • PowerPC
    • PowerPC64
  • SPARC platform that is available on Solaris:
    • sparcv9
  • IBM Z platforms that are available on Linux
    • s390
    • s390x
The list might change with time because the REST API stores the same value that is returned by the operating system. 		String
pvu_per_core PVU per Core Number of PVUs that are assigned to a processor core on the computer. By default, the value is taken from the PVU table. Numeric
server_cores Server Cores Number of active physical processor cores on the physical server. Numeric
server_id The property is not displayed on the report. Internal identifier of the physical server that hosts a computer. In case of a virtual machine that is not fully defined, the ID is a placeholder for a physical server and it changes when you complete defining the virtual machine. Numeric
server_logical_cores Logical Processors (The property is displayed only on Software Classification report) Number of logical processor cores on the physical server according to processor capabilities and configuration. For example, when hyper-threading is used on the x86 processors, the value represents the number of hyper-threaded cores. Numeric
9.2.16 server_model Server Model A model of a physical server. String
server_name Server ID A unique system in the infrastructure. For a physical machine, it is the hardware manufacturer, type, and a machine serial number. For a virtual machine, it is the manufacturer and host name. For artificial server with incomplete definition, it is a UUID of a virtual machine prefixed with TLM_VM_.

You can specify the data that is returned by this property by configuring the following advanced server settings: managedServerTagTemplate and standaloneServerTagTemplate. For more information, see: Configuring advanced server settings.

 String
9.2.16 server_serial_number Server Serial Number A serial number of a physical server. In case of a virtual machine that is not fully defined, the Server Serial Number is a UUID that is prefixed with TLM_VM_. String
9.2.16 server_type Server Type A type of a physical server. String
9.2.16 server_vendor Server Vendor A manufacturer of a physical server. String
shared_pool_id Shared Pool ID Identifier of IBM POWER shared processor pool. String
status Status Status of the computer. Possible values are:
  • 1 - OK
  • 2 - No Scan Data
  • 3 - No Host Scan Data
  • 4 - No VM Manager Data
  • 9.2.10 5 - Outdated VM Manager Data
 String
system_model System Model Name of the hardware system or virtualization technology that is discovered by the BigFix client. String
The following properties identify the Current Physical Server Processor. In case of a virtual machine that is not fully defined, the information is gathered on VM level.
Table 2. Columns with properties that identify the Current Physical Server Processor
Property Name on the Hardware Inventory report Description Type
processor_brand_string Processor Brand String Full specification of the processor including its brand, model and speed as read from the computer operating system. String
processor_brand Brand Brand of the processor that was matched in the PVU table. If the brand is "Other", the processor is not listed in the PVU table. String
processor_model Model Model of the processor. String
processor_type Type Type of the processor according to the number of cores. String
processor_vendor Vendor Vendor of the processor. String