computer association

Available from 9.2.10. Use the computer association to retrieve information about details of the computer and custom computer properties as part of REST API requests.

Association

computer

Applicable REST APIs

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

Syntax

<URL>?columns[]=computer.<column>&token=<token>
For example:
GET api/sam/raw_file_facts?columns[]=computer.ip_address
&token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623

Schema description

To retrieve the list of all columns that are returned by this association together with their descriptions, use the following request. The list contains custom computer properties that were added on the Computer Properties panel.
GET api/sam/schemas/associations/computer.json?token=<token>

Available columns

Table 1. Columns with information about computer details
Column Description Type
id Identifier of the computer as specified in the BigFix InventoryLicense Metric Tool database. Integer
remote_id Identifier of the computer as specified in the BigFix database. Integer
last_seen Date and time when the BigFix client connected to the BigFix server the last time. String
datasource_id Identifier of the BigFix server to which the computer reports. Integer
datasource_name Name of the BigFix server to which the computer reports. String
created_at Date and time when the information about the computer was imported from BigFix for the first time. String
valid_to The date and time when the computer stopped being discovered, for example because it was removed from the infrastructure, the data source was removed, or the BigFix client was uninstalled. String
os Operating system of the computer. String
dns_name Name of the computer that is specified in the Domain Name System. String
name Host name of the computer. String
ip_address IP address of the computer. String
computer_property_number Custom computer property that was added on the Computer Properties panel. To view the list of all custom properties, view the computer schema. The name of the property as displayed on the user interface is shown in the title parameter. String