designated_computer association
Available from 9.2.12.
Use the
designated_computer association to retrieve information about computers that were
designated to scan shared disks as part of other REST API requests.
Note: This association can be used to retrieve information about
computers on which the BigFix® client is installed.
It cannot be used to retrieve information about computers on which the disconnected scanner is
installed because the scanner does not gather information about shared disks.
Association
designated_computerApplicable REST APIs
You can use the
designated_computer association with the following REST APIs:
Syntax
<URL>?columns[]=designated_computer.<column>For
example:
GET https://hostname:port/api/sam/v2/shared_disks?columns[]=designated_computer.ip_addressSchema 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/designated_computer.jsonAvailable columns
| Property | Description | Type |
|---|---|---|
| id | Identifier of the computer that was designated by License Metric Tool to scan the shared disk as specified in the License Metric Tool database. | Integer |
| remote_id | Identifier of the computer that was designated by License Metric Tool to scan the shared disk as specified in the BigFix database. | Integer |
| last_seen | Date and time when the computer reported to BigFix for the last time. The time is specified in the GMT time zone. | 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 |