Retrieval of information related to physical processors (v2)

Available from 9.2.12. You use the GET operation on the api/sam/v2/detailed_hw_physical_processors element to request information related to all active physical processors.

Permissions

User You must have the View Endpoints and View Hardware Inventory permission to use this API.

Resource URL

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

Resource information

Table 1. Resource information
Operation details Description
HTTP method GET
Request headers
Header
Accept-Language (optional)
Values
en-US (only English is supported)

Negotiates the language of the response. If the header is not specified, the content is returned in the server language.
Request format application/json
Response headers
Header
Content-Type
Values
application/json

Specifies the content type of the response.
Header
Content-Language
Values
en-US, …

Specifies the language of the response content. If the header is not specified, the content is returned in the server language.
Response payload Physical Processors element
Response format application/json
Response codes

200 – OK

500 – "Bad Request" if a query parameter contains errors or is missing

Schema description

To retrieve the list of all columns that are returned by this REST API together with their descriptions, use the following request.
GET api/sam/v2/schemas/detailed_hw_physical_processor.json?token=token

Available columns

The list of attributes related to all active physical processors including single chips and processor packages. You can retrieve values for each platform working as a host which translates into one operating system per physical processor.
Note: To retrieve information about physical processors for guest operating systems, such as VMware or BigFix LPAR, the complete information for the physical machine must be available.

The scan output might contain multiple instances of each attribute from this group.

Table 2. Columns with information about physical processors
Property Description Type
id Identifier of the record. Integer
computer_id Identifier of the computer as specified in the BigFix Inventory database Integer
updated_at Date and time when the current information was imported to BigFix Inventory. String
core_per_package_count The number of cores on a physical processor; for example, 8 cores for Intel Xeon E5-4620, and 12 for POWER9. String
logical_proc_per_core The number of logical processors assigned for each core; for example, 2 for Intel Xeon E5-4620, and 8 for POWER9. String
manufacturer Processor manufacturer; for example Intel, AMD, or BigFix.
Note: You can only retrieve information about the manufacturers that are supported by the scanner. Otherwise, the displayed value is Unknown.
 String
family Processor family; for example, Xeon, or POWER9.
Note: You can only retrieve information about the processor families that are supported by the scanner. Otherwise, the displayed value is Unknown.
 String
type Processor type; for example, E5-4620 for Intel Xeon E5-4620.
Note: If the scanner does not support type identification of the processor family the value is empty. If the scanner supports type identification for the processor family, however, the given types is not recognize, the displayed value is Unknown.
String
cpu_freq Processor frequency in megahertz (MHz). This information is optional, and vendor-specific. Depending on the processor family the value might represent either nominal or current CPU frequency.
Note: CPU frequency might be interpreted differently across processor architectures and families. If this information is not applicable the value is 0.
String
brandname Processor name. This information is optional, and specific to platform and vendor. Thus, it can be retrieved from a different source in case of each platform, or even processor family. If available, it is a copy of a value reported by CPUID instruction, BIOS or OS. String
active_processor_count The number of active processors in the physical processor. A processor is active if a logical processor is running on this physical processor. String
active_core_count The number of active cores in the physical processor. The core is active if a logical processor is running on this core. String

Related APIs

This API can be associated with the following API:

Query parameters

Table 3. Query parameters
Parameter Description Required Value
columns[] Specify which columns to retrieve. If you do not specify this parameter, only default columns are retrieved.
Example: Retrieve the computer id:
URL?columns[]=computer_id
 String
order Specify how to sort the returned data. The default direction for sorting columns is ascending. If you want to specify a descending sort, append desc to the column name.
Example: Order by computer ID descending:
URL?order[]=computer_id desc
 String
limit Specify the number of rows to retrieve. If you omit this parameter, all rows are retrieved.
Example: Retrieve 100 records 
URL?limit=100
Note: By default the limit parameter for this API is set to 100000.
 Numeric
offset Specify the number of rows to skip for retrieving results. You can use it together with the limit parameter to paginate results.
Example: Retrieve 50 records starting after record 150
URL?limit=50&offset=150
 Numeric
token A unique user authentication identifier. You can retrieve it by using REST API for retrieving authentication token. You can also log in to BigFix Inventory, hover over the User icon User icon, and click Profile. Then, click Show token. ✓ Alphanumeric
criteria Retrieve records which match specific conditions. The parameter should have the following structure, written in one line: 
<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>

For more information about operators, see: Common connectors and operators.

Example: retrieve computers with computer ID greater than 1000.
URL?criteria={"and":[["computer_id", ">", "1000"]]}

For columns that use the date and time values, you can retrieve data also for a period instead of a specific date. To do so, use last or next as <operator>, and then specify the time value in the following convention: PxD/PxW/PxM/PxY, where x is a number in the 1-999 range, and D, W, M, or Y is a designator that represents days, weeks, months, or years respectively.

String

Example conversation - default columns

Request
GET api/sam/v2/detailed_hw_physical_processors?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
Host: localhost:9081 
Accept: application/json 
Accept-Language: en-US
Response body
[{
"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"
}]

Example conversation - selected columns

Request 
GET api/sam/v2/detailed_hw_physical_processors?columns[]=computer_id
&columns[]=manufacturer&columns[]=family&columns[]=type
&token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
Host: localhost:9081 
Accept: application/json 
Accept-Language: en-US
Response body
[{
"computer_id":4,
"manufacturer":"Intel",
"family":"Xeon",
"type":"E7-8880"
}]